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Abstract 

The  Computer  Center  in  the  Computer  and  Information  Services 
Department  of  the  David  Taylor  Research  Center  has  installed  an 
Integrated  Supercomputer  Network.  This  manual  provides  an  introduction 
to  the  Network.  Some  information  has  been  distilled  from  many 
individual  documents  and  augmented  to  reflect  usage  at  DTRC.  Control 
statement  examples  and  descriptions  of  hardware  and  software  are 
included,  as  is  information  on  moving  files  among  the  CDC  CYBER  860A 
(with  the  Mass  Storage  System),  the  DEC  VAXcluster,  the  secure  DEC  VAX, 
and  the  CRAY  X~MP ,  creating  and  executing  batch  jobs,  and  using  the 
interactive  systems.  Volume  1  describes  the  CRAY  X~MP,  the  Mass 
Storage  System,  and  the  DEC  VAXes.  Volume  2  describes  the  CDC  CYBER 
860a. 


Administrative  Information 

The  work  described  in  this  report  was  performed  in  the  Scientific 
and  Engineering  Support  Branch  (3511)  of  the  Computer  and  Information 
Services  Department,  David  Taylor  Research  Center,  under  the  sponsorship 
of  the  DTRC  Computer  Center  (351). 
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*****  CDC  CYBER  180/860  —  NOS/VE  ***** 

The  Control  Data  Corporation  (CDC)  CYBER  180  model  860  when 
operating  under  NOS/VE  has  a  single  central  processing  unit  (CPU)  and 
1,048,576  64-bit  words  (8  Mbytes)  of  physical  memory.  Each  user  job 
has  a  maximum  virtual  address  space  of  4096  segments  of  up  to  4  Gbytes 
(4  billion  bytes)  per  segment. 

The  CPU  has  32  registers  for  operating  on  information:  16  address 
(A),  and  16  operand  (X)  registers.  The  CYBER  860  has  a  buffer  of  12 
central  memory  (CM)  words  of  instructions,  called  an  instruction  stack, 
and  a  2048-word,  high-speed  cache  memory  for  operands. 

All  system  input  and  output  (I/O)  is  handled  by  25  small, 
independent  computers  called  peripheral  processors  (PPs)  .  Each  PP  has 
4096  12-bit  words  of  memory,  and  is  able  to  access  all  8  megabytes  of 
CM  without  help  from  the  CYBER  860  CPU. 

Connected  to  this  bank  of  PPs  are  28  normal  and  5  concurrent  I/O 
channels  which  provide  data  and  control  signal  paths  to  the  CYBER  860 
peripheral  equipment.  System  I/O  consists  of  data  transfers  between  CM 
and  the  peripheral  equipment  under  control  of  the  PPs  via  these 
channels.  This  I/O  scheme  allows  the  CPU  to  dedicate  itself  to 
computation,  providing  high  performance. 


***  NOS/VE  Version  1.5.1  *** 

One  operating  system  for  the  CDC  CYBER  860  at  DTRC  is  called  the 
Network  Operating  System  /  Virtual  Environment,  version  1.5.1  (NOS/VE 
1.5  -  level  739)  and  differs  only  slightly  from  the  standard  NOS/VE 
system.  The  interactive  subsystem,  when  entered  via  NOS,  is  called 
VEIAF  (NOS/VE  InterActive  Facility).  Medium-speed  remote  batch 
terminals  are  accessed  via  NOS. 

Permanent  files  (user  programs  and  data  files  retained  for  frequent 
use)  reside  on  ndel  895  disk  drives  and  the  Mass  Stoiage  System.  User 
files,  if  not  specifically  requested  on  a  tape,  will  be  assigned  to 
available  disk  areas. 

NOS/VE  operates  in  a  "dual-state"  with  NOS  (see  chapter  9). 
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***  Accessing  NOS/VE  on  the  CDC  CYBER  860 

To  access  NOS/VE  on  the  CDC  CYBER  860: 

.  dial  (301)  227-5200  < —  this  will  connect  you  with  DTNET 

at  1200  baud  (see  page  1—1 —A  for 
higher  speeds) 

.  press  the  RETURN  key  until  it  displays  the  DTNET>  prompt 

.  enter  "connect  cdc860"  (or  "c  cdc860")  to  connect  to  NOS 

.  in  response  to  the  Family:  prompt,  enter  either 
.  , xxxx , pw, VEIAF  (xxxx  is  your  User  Initials, 
pw  is  your  login  password 

VEIAF  is  the  NOS/VE  InterActive  Facility) 

-or- 

,  RETURN,  then  the  rest  of  the  information  one  item  at  a  time 
as  prompted 

.  in  response  to  the  Enter  Account  Number:  prompt,  press  RETURN 

.  in  response  to  the  Enter  Project  Number:  enter  a  dollar  sign 
($)  followed  by  your  Job  Order  Number 

,  when  you  receive  the  "/"  prompt,  you  are  in  NOS/VE 
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***  Terminal  Keys  *** 

NOS/VE  supports  screen  formatting  for  most  display  terminals.  Many 
commands  use  a  full-screen  mode  when  the  interaction  style  is  SCREEN. 
When  these  commands  show  function  keys,  they  are  shown  for  the  terminal 
mode  you  have  defined  (default  is  CDC  Viking  721  terminal) . 

"CHANGE_TERMINAL_ATTRIBUTE  TERMINAL_MODE=DEC_VT100_GOLD"  before 
EDIT_FILE  defines  the  following  keypad: 


PF1 


PF2 


PF3 


UNMARK 

mark 

|  MRK  BX 
|  mrk  ch 

|  LOC  NXT 
locate 

!  WIDTH 
]  loc  all 

7 

DEL  CH 
ins  ch 

!8 

]  DEL  LIN 
ins  lin 

<9 

j  LIN  UP 
[  move 

|  JOIN 
]  break 

A 

COPY 

help 

!  5 

1 

1 

|  undo 

1 6 

|  EXIT 

I  quit 

1  1 

j  CLR  EL 
|  skp  el 

1 

FIRST 

bkw 

!  2 

|  LAST 
]  fwd 

[  3 

]  HOME 
|  back 

| ENTER 

0 

< 

gold> 

1 

\ 

1 

1 

1 

|  REFRSH 
j  middle 

or  more  of  the  keypad  keys 
!  requested  functions. 

,  the  RET 

may  be 

used  to  position  the  cursor. 

PFA 
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***  Permanent  Files  *** 

Unlike  NOS,  NOS/VE  supports  only  one  type  of  file. 

Disk  space  is  allocated  and  charged  by  PRU  (physical  record  unit) 
with  one  PRU  holding  64  words  (512  8~bit  characters). 
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***  Batch  Jobs 

A  batch  job  is  created  and  submitted  to  the  Input  Queue  from  an 
interactive  session.  This  may  be  done  interactively,  or  the  batch  job 
may  be  put  into  a  file  and  the  file  executed  (putting  the  job  into  the 
input  queue).  Two  commands  are  available  for  submitting  batch  jobs: 
JOB  (creates  the  job  and  submits  it)  and  SUBMIT_JOB  (submits  an 
existing  file  containing  a  batch  job).  SUBMIT_JOB  requires  that  the 
file  contain  a  LOGIN  statement  as  the  first  statement  of  the  job. 

Since  the  LOGIN  statement  contains  your  password,  SUBMIT_JOB  is  not 
recommended  and  should  be  used  only  if  your  are  executing  as  another 
user . 

1)  Interactively: 

/job  job_name=compile 

job/fortran  i=$user .myprog  l=list_file 
j ob/print_f i le  list_file 
job/lgo 
j  ob/ j  obend 
/ 

~or~ 

/Col lect_Text  $local . submit_f i le 
ct?  login  login_user=xxxx 
ct?  password=pw 

ct?  fortran  i=$user .myprog  l=list_fiie 

ct?  print_file  list_file 

ct?  lgo 

ct?  logout 

ct?  ** 

/Submit  Job  Slocal . submit  file 


2)  From  a  file: 

File  Suser.myjob  contains: 

job  job_name=compile 

fortran  i=$user .myprog  1  =  1 i s t _ f i 1 e 

print_file  list_file 
lgo 

j  obend 

To  submit  the  job  file: 

/Include_Fi le  Suser.myjob 

/ 


-or- 


File  Suser.mysjob  contains: 

login  login_user=xxxx  password=pw 
fortran  i=$user .myprog  l=list_file 
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print_file  list_file 
lgo 

logout 

To  submit  the  job  file: 
/Submit_Job  $user.mysjob 


**  Following  Batch  Job  Progress  ** 

The  DISPLAY_JOB_STATUS  (disjs)  command  will  display  information 
about  your  batch  job.  By  default,  all  information  is  shown.  See 
Appendix  H  for  available  parameters. 


**  Killing  Batch  Jobs  ** 

The  TERMINATE_JOB  (terj)  command  is  used  to  terminate  a  job.  See 
Appendix  H  for  available  parameters. 


**  Batch  Job  Classes  ** 

Batch  jobs  in  NOS/VE  have  only  one  service  classes  or  priority. 
SECURE  processing  is  not  available  on  the  CYBER  860. 

For  the  current  rates: 

On  NOS/VE:  RATES 
-or- 

RATES.file  < —  puts  a  copy  of  the  rates  into  a  file 
On  NOS:  BEGIN, RATES 


On  VMS: 


HELP  RATES 
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I 

*****  NOS/VE  SCL  Commands  ***** 

The  NOS/VE  System  Control  Language  (SCL)  statements  are  grouped  by 
function  in  this  section.  See  Appendix  H  for  a  description  of  the 
syntax  for  each  command.  (DTRC)  indicates  a  command  or  program  added 
at  DTRC. 


***  Flow  Control  ,c,“' 

"  Comment . 

BLOCK  Group  a  sequence  of  statements  into  a  block. 

CONTINUE  Exit  the  current  WHEN  statement. 

CYCLE  Execute  the  next  iteration,  if  any,  of  a  repetitive  command. 

EXIT  Transfer  control  out  of  a  structured  statement,  command  or 
function  procedure,  or  command  utility. 

FOR  Control  repetition  of  a  list  of  statements. 

IF  Conditional  execution  of  one  or  more  statement  lists. 

INCLUDE_COMMAND 

Include  a  string  containing  SCL  statements  into  the  command 
stream. 

INCLUDEJFILE 

Insert  a  text  file  of  SCL  commands  into  the  command  stream. 
INCLUDE_LINE 

Insert  a  string  containing  SCL  statements  into  the  command 
stream. 

LOOP  Repeat  forever  a  statement  list. 

REPEAT  Conditionally  repeat  a  statement  list. 


***  Job  Control  *** 

BLOCK  Group  a  sequence  of  statements  into  a  block. 
CANCEL  Cancel  the  most  recently  selected  conditions. 
CAUSE 

» 


Cause  a  condition  to  occur. 
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CHANGE_COMMAND_SEARCH_MODE 

Change  the  command  list  search  mode. 

CHANGE_INPUT_ATTRIEUTE 

Change  an  input  job's  attributes  —  resubmit  a  job. 

CHANGE_JOB_ATTR I BUTE 

Change  tne  current  job's  attributes. 

CHANGE_JOB_LIMIT 

Change  a  job's  resource  limits. 

CHANGE_LOGIN_PASSWORD 

Set  or  change  your  login/batch  password. 

CHANGE_MESSAGE_LEVEL 

Select  the  NOS/VE  message  display  format. 

CHANGE_OUTPUT_ATTRIBUTE 

Change  an  output  file's  attributes. 

CHANGE_SCL_OPTION 

Change  the  options  provided  by  the  SCL  interpreter. 

CHANGE_UT I LI T Y_ATTR I BUTES 

Change  the  attributes  of  a  utility  command  (UTILITY/ 
UTILITYEND) . 

COMMAND  Declare  an  entry  in  utility  command  table. 

CREATE_COMMAND_L I ST_ENTRY 

Add  entries  to  the  beginning  of  end  of  the  command  list. 
DEFINE_PRIMARY_TASK 

Designate  the  requesting  task  as  the  primary  task  for  the  job. 

DELETE_COMMAND_LIST_ENTRY 

Delete  entries  from  the  command  list. 

DETACHJOB 

Explicitly  disconnect  your  terminal  from  the  current  job. 
DISPLAv_JOB_ATTRIBUTE 

Display  the  attributes  of  your  current  job. 

DISPLAY_L0G 

Display  the  job  log  for  the  requesting  job. 

DISPLAY_MESSAGE 

Display  a  message  in  one  or  more  logs. 

DI SPLAY_OUTPUT_ATTR I BUTE 

Display  attributes  of  an  output  file. 

DISPLAY_0UTPUT_HIST0RY 

Display  job  log  entries  for  output  files. 
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DI SPLAY_OUTPUT_STATUS 

Display  the  status  of  a  file  in  the  output  queue. 
DISPLAY_PROGRAM_ATTRIBUTES 

Display  the  current  job  library  list  and  default  execution 
option  values. 

DISPLAY_SCL_OPTIONS 

Display  the  options  set  by  CHANGE_SCL_OPTIONS. 

D I SP  LAY_TASK_S  T ATUS 

Display  the  status  of  one  or  more  tasks. 

EXECUTEJZOMMAND 

Execute  a  single  command  asynchronously  in  a  new  task. 

EXECUTE_INTERSTATE_COMMAND 

Execute  a  NOS  command. 

JOB  Generate  and  submit  a  batch  job. 

RESUME_C  OMMAND 

Resume  a  job  activity  interrupted  by  a  pause  break. 

SET_SENSE_SWITCH 

Sets  sense  switches  on  or  off. 

STATUS_CRAY 

(DTRC)  Display  the  status  of  Cray  jobs. 

SUBMIT_CRAY_JOB 

(DTRC)  Submit  a  job  to  the  Cray. 

SUBMIT_DETATCHED_JOB 

Start  a  disconnected  interactive  job. 

SUBMIT_JOB 

Submit  a  NOS/VE  batch  job. 

TASK  Delimit  a  sequence  of  SCL  statements  to  be  as  a  synchronous 
or  an  asynchronous  task. 

WAIT  Suspend  command  processing  for  a  time  period  or  until  an  event. 

WHEN  Delimit  SCL  statements  to  be  executed  when  a  specified 

condition  occurs. 

WHILE  Conditionally  repeat  a  statement  list. 
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***  Interactive 


**  Terminal  Control  ** 

CHANGE  _C0NNECT I ON_ATTR I BUTES 

Change  the  terminal  file's  connection  attributes. 

CHANGE_INTERACTION_STYLE 

Change  from  line  mode  to  screen  mode  or  vice  versa. 

CHANGE_L I NK_ ATTR I BUTES 

Change  individual  link  attributes  for  communication  between 
dual-state  partners. 

CHANGE_TERMINAL_ATTRIBUTES 

Define  and  change  an  interactive  terminal's  attributes. 
CHANGE_TERM_CONN_DEFAULTS 

Change  a  terminal's  default  connection  atttributes. 
CREATE_INTERSTATE_CONNECTION 

Establish  a  NOS  batch  control  point  or.  a  dual-state  system. 
DEFINEJTERMINAL 

Compile  your  terminal  definition  file. 

DELETE_INTERSTATE_CONNECTION 

Terminate  the  interstate  connection. 

DES I GN_SCREEN 

Enter  the  Screen  Design  Facility  (SDF) . 

DISPLAY_CONNECTION_ATTRIBUTES 

Display  the  terminal  file's  connection  attributes. 

DISPLAY_LINK_ATTRIBUTES 

Display  individual  link  attribute  values. 

DI SPLAY_TERMINAL_ATTR I BUTES 

Display  interactive  terminal  attribute  values. 

DISPLAY_TERM_CONN_DEFAULTS 

Display  the  defaults  for  terminal  connection  attributes. 

INITIALIZE_TERMINAL 

Change  the  terminal  settings. 

REQUEST_TERMINAL 

Associate  a  file  with  a  terminal  in  an  interactive  job. 

SET_LINK_ATTRIBUTES 

Use  CHANGE  LINK  ATTRIBUTES. 
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**  Interactive  Status  ** 

‘/.A  Same  as  DISPLAY_ACTIVE_TASKS  . 

*/iD  Immediately  detach  a  terminal  job  from  the  terminal  (same  as 

DETACH_JOB) . 

’/.J  Immediate  detailed  job  status  (same  as  DISPLAY_JOB_STATUS)  . 

*/.S  Immediate  abbreviated  job  status. 


**  Job  Processing  ** 

DISPLAY_ACTIVE_TASKS 

Display  tasks  executing  within  the  current  job. 

DI S  T  LAY_COMMAND_ I NFORMAT I ON 

Display  information  about  a  command. 

DISPLAY_COMMAND_LIST_ENTRY 

Display  information  about  one  or  more  entries  in  a  command 

list. 

DISPLAY_COMMAND_LIST 

Display  information  about  the  command  list. 

DISPLAY_JOB_ATTRIBUTE_DEFAULT 

Display  the  current  defaults  for  the  job  attributes. 

DISPLAY_JOB_LIMIT 

Display  your  job's  limits. 

DISPLAY_JOB_STATUS 

Display  current  status  of  queued  or  executing  jobs. 

DISPLAY_TOPICS_FILE 

Open  a  Topics  online  manual. 

ECHO  (DTRC)  Control  echoing  of  SCL  statements  to  a  file. 

EXPLAIN  Open  an  on-line  manual. 

EXPLAIN_MESSAGE 

Request  a  description  of  a  system  message. 
GENERATE_COMMAND_TABLE 

Generate  command  and  function  tables  for  a  command  environment. 
HELP  Open  an  on-line  manual. 

KERMIT  Begin  a  KERMIT  file  transfer  session. 
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LOGIN  Provide  access  to  NOS/VE  batch  services. 

LOGOUT  Terminate  a  batch  or  interactive  job. 

MANAGE_JOB 

Begin  a  utility  that  manages  the  selection  and  control  of  one 
or  more  jobs. 

MANAGE_OUTPUT 

Begin  a  utility  that  manages  the  selection  and  control  of  one 
or  more  output  files. 

PUSH_COMMANDS 

Move  the  command  list  entry  containing  the  procedure  that 
call  this  statement  to  the  top  of  the  command  list. 


ROUTE_JOB 

(for  input  from  cards,  or  a  PC  or  terminal  supporting  HASP) 
Name  a  job  and  the  output  destination. 

SET_COMMAND_LIST 

Add  to  and/or  delete  from  the  current  command  list,  and/or 
alter  the  state  of  the  search  mode  indicator. 

SET_DEBUG_LIST 

Add  or  delete  debug  object  libraries  to/from  the  job  debug 
library  list. 

SET_DEBUG_RING 

Specify  the  ring  in  which  Debug  is  to  execute. 
SET_DEFAULT_LOGIN_PROJECT 

(DTRC)  Set  the  default  login  project  number  (job  order  number 
at  DTRC)  so  that  it  need  not  be  entered  at  future  logins. 

TERMINATE_COMMAND 

Terminate  the  program  interrupted  by  a  pause  break  (%1) . 

TERM INATE_ JOB 

Terminate  queued  or  executiong  jobs. 

TERMINATE_TASK 

Delete  asynchronous  tasks  (and  all  tasks  generated  by  those 
tasks) . 

XMODEM_RECEIVE 

Receive  a  file  send  from  a  PC  using  XMODEM. 

XMODEM_SEND 

Send  a  file  to  a  PC  using  XMODEM. 
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***  File  Management  *** 

CHANGE_WORKING_CATALOG 

Establish  the  default  working  catalog. 

COLLECT_TEXT 

Copy  lines  of  text  from  the  command  list  to  a  specified  file. 
COMPARE_FILE 

A  binary  comparison  of  two  files. 

COPY_FILE 

Copy  a  file. 

CREATE_FILE_CONNECTION 

Create  a  connection  between  two  files  so  that  any  data  access 
request  against  the  subject  file  is  pass  to  the  target  file. 

DELETE_FILE_CONNECTION 

Delete  the  connection  between  files. 

DISPLAY_FILE 

Display  a  file  in  hexadecimal  and/or  ASCII. 
DISPLAY_FILE_CONNECTIONS 

Display  the  names  of  the  files  currently  connected  to  the 
subject  files. 

DISPLAY_INPUT_ATTR IBUTE 

Display  the  input  attributes  of  a  queued  or  processing  job. 
ENTER_F I LE_MANAGER 

Begin  a  File  Manager  utility  session. 

F I LE_MANAGEMENT_UT I L I T Y 

Execute  the  File  Management  Utility. 

GET_FILE 

Copy  a  NOS  file  to  NOS/VE. 

MERGE  Merge  sorted  records  from  one  or  more  files  and  write  them 
in  sorted  order  to  a  single  output  file. 

OP  EN_F I LE_M I GRAT 1 0N_A I D 

Begin  the  file  migration  environment. 

PRINT_FILE 

Print  one  or  more  files. 

PUT_LINE 

Write  lines  to  a  file. 
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REPLACE_FILE 

Copy  a  NOS/VE  file  to  NOS  direct  file,  replacing  any  existing 

file. 

REWIND_FILE 

Position  a  file  at  BOI  (beginning-of-information) . 


SHOWJFILE 

Display  a  file  in  a  pop  up  window  that  provides  editing 
opt i ons . 

SORT  Sort  records  from  one  or  more  files  and  write  them  in  sorted 

order  to  a  single  output  file. 

TERMINATE_OUTPUT 

Delete  output  files. 


Permanent  File 


BACKUP_PERMANENT_F I LES 

Begin  a  utility  session  to  back  up  permanent  files  and 
catalogs . 

CHANGE_CATALOG_CONTENTS 

Delete  damage  condition  notices  from  files  in  the  specified 
catalog  and  all  its  subcatalogs,  and  delete  catalog  entries 
for  files  with  no  cycle  data. 

CHANGE_CATALOG_ENTRY 

Change  a  file's  catalog  entry  itero(s). 

CHANGE_F I LE_ATTR I BUTES 

Change  an  existing  file's  attributes. 

CREATE_CATALOG 

Create  a  new  catalog. 

CREATE_CATALOG_PERMIT 

Grant  or  deny  permission  to  use  a  catalog. 

CREATE_FILE 

Create  a  new  file  (or  cycle  of  a  file)  and  attach  it  to  the 
j  ob . 

CREATE_FILE_PERMIT 

Establish  or  modify  an  access  control  entry  for  a  file. 
DELETF._ALL_CYCLES 

(DTRC)  Delete  all  cycles  of  one  or  more  files. 
DELETE_CATALOG 

Delete  a  catalog  and,  optionally,  its  contents. 
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DELET  E_CATALOG_PERM I T 

Delete  an  access  control  entry  for  a  catalog. 

DELETE_riLE 

Delete  a  file  or  cycle  of  a  fil-. 

DELETE_F1LE_PERMIT 

Delete  an  access  control  entry. 

DETACH_FILE 

Detach  one  or  more  files  from  a  job. 

DISPLAY_CATALOG 

Audit  files  and  catalogs  in  a  specific  catalog  or  about  the 
access  control  list  at  the  catalog  level. 

D ISP LA Y_CATALOG  ENTRY 

Audit  a  file,  its  usage,  or  its  access  control  list. 
DISPLAY_FILE_ATTRIBUTES 

Display  selected  attributes  of  one  or  more  files. 

DISPLAYWORKINGCATALOG 

Display  your  working  catalog. 

EDIT_CATALOG 

Begin  an  EDIT_CATALOG  utility  session. 

PURGE  (DTRC)  Delete  cycles  of  one  or  more  files  keeping  the 
specified  number  of  high  cycles. 

RESTORE_PERMANENT_FILES 

Begin  a  RESTORE_PERMANENT_FILES  utility  session. 

SET_HLE_ATTRIBUTES 

Set  the  attributes  of  a  file. 


***  Mass  Storage  System  File  *** 

MSACCES  (DTRC)  Access  the  Mass  Storage  System  (MSS) . 

MSAUDIT  (DTRC)  Obtain  a  sorted  audit  of  your  MSS  files. 

MSCATLIST  (DTRC)  The  NOS  CATLIST  command. 

MSCHANG  (DTRC)  Change  the  attributes  of  a  Mass  Storage  System  file. 

MSFETCH  (DTRC)  Fetch  a  file  from  the  Mass  Storage  System. 

MSFILES  (DTRC)  Obtain  a  sorted  list  of  indirect  and  direct  Mass 
Storage  System  file  names. 

MSPASSW  (DTRC)  Change  you r  Mass  Storage  System  access  password. 
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MSPURGE  (DTRC)  Purge  a  file  on  the  Mass  Storage  System. 
MSSTORE  (DTRC)  Store  a  file  on  the  Mass  Storage  System. 


***  Cray  *** 

STATUS_CRAY 

(DTRC)  Display  the  status  of  Cray  jobs. 
SUBMIT_CRAY_JOB 

(DTRC)  Submit  a  job  to  the  Cray. 

***  Load/Dump  Memory  *** 


”’”r  Tape  Management 

CHANGE_ 1 7 0_R EQUE S T 

Change  the  170  tape  file  description  in  a  temporary  NOS/VE  file 
formed  in  a  preceding  CREATE_170_REQUEST  command. 

CHANGE_BACKUP_LABEL_TYPE 

Change  the  job  default  label  type  for  backup  to  tape. 
CREATE_170_REQUEST 

Create  a  NOS/VE  temporary  file  to  be  associated  with  a  170 
(NOS)  tape  file. 

CREATE_VAX_REQUEST 

Create  a  NOS/VE  temporary  file  to  be  associated  with  a  VAX 
tape  file  used  for  future  references  to  the  VAX  tape  file. 

DISPLAY_BACKUP_LABEL_TAPE 

Display  the  current  job  default  label  type  for  a  permanent 
file  backup  file  on  tape. 

DISPLAY_TAPE_LABEL_ATTRIBUTES 

Display  the  current  magnetic  tape  label  attributes. 

RELEASEJRESOURCE 

Release  tape  reservations. 

REQUEST_MAGNETIC_TAPE 

Associate  a  file  with  a  magnetic  tape. 

RESERVE_RESOURCE 

Specify  the  number  of  tape  units  to  be  reserved. 
RESTORE_FOREIGN_FILES 

Begin  a  RESTORE_FOREIGN_FILES  utility  session  to  migrate 
NOS  tape  files  to  NOS/VE. 
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SKIP_TAPE_MARK 

Position  a  tape  backward  or  forward. 


Vc 


Procedures 


Vc  Vc  Vc 


PROCEDURE 

First  statement  of  an  SCL  procedure  defining  the  procedure's 
names,  attributes,  and  parameters. 


System  Utilities 


ANALYZE_OBJECT_LIBRARY 

Begin  an  ANALYZE_OB JECT_LIBRARY  utility  session. 
ANALYZE_PROGRAM_DYNAMICS 

Measure  program  execution  characteristics  and  restructure 
program  as  a  single  load  module. 

ANY_MAIL  (DTRC)  Check  for  mail. 

CH ANGE  JJT I L I T Y_ATTR I BUTES 

Change  the  attributes  of  a  utility  command  (UTILITY/ 
UTILITYEND) . 

CHECK_F  OR_MA I L 

Check  for  unread  mail. 

COMPRESS_MAIL_DATABASE 

Create  a  new  copy  of  your  mailbox  file  (MVF$ELECTRONIC_MAIL_ 
DATABASE)  in  your  master  catalog,  with  unused  space  removed 
and  any  data  faults  corrected. 

CONVERT_UPDATE_TO_SCU 

Convert  an  UPDATE  source  library  to  SCU  format. 

CREATE_MANUAL 

Read  a  source  file  of  directives  and  text  to  create  an  on-line 
manual  for  use  by  EXPLAIN. 

CREATE_TOPICS_FILE 

Create  a  Topics  manual  from  a  text  file  using  binding. 
DECRYPT_FILE 

Decrypt  a  file  encrypted  using  ENCRYPT_FILE. 

DISPLAY  JFUNCTI0N_INF0RMATI0N 

Display  information  about  a  function. 

EDIT_FILE 

Begin  a  file  editor  (EDIT_FILE  utility)  session. 

EMAIL 

Begin  a  Mail/VE  session. 
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FUNCTION 

First  statement  of  an  SCL  function  defining  the  function’s 
names,  attributes,  and  parameters. 


FUNCTION 

(UTILITY  subcommand)  Declare  an  entry  in  a  utility  function 
table. 

MANAGE_FORM 

Begin  a  MANAGE_FORMS  utility  session. 

MEASURE_PROGRAM_£XECUTION 

Begin  a  program  measurement  utility  session. 

RESTORE_LOG 

Begin  a  RESTORE_LOG  utility  session. 

TABLEND  (UTILITY  subcommand)  End  the  collection  of  utility  command 
table  definitions. 

UTILITY 

Delimit  the  definition  and  execution  of  a  command  utility. 


***  Library  Maintenance  *** 

COMPARE_OB JECT_LIBRARY 

Compare  two  object  libraries  or  two  object  files. 
CONVERT_UPDATE_TO_SCU 

Convert  an  UPDATE  source  library  to  SCU  format. 
CREATE_OBJECT_LIBRARY 

Begin  a  CREATE_OB JECT_LIBRARY  utility  session. 

CREATE_PP.OGRAM_PROFILE 

Generate  a  program  profile. 

DISPLAY_OBJECT_LIBRARY 

Display  information  about  an  object  library,  object  file,  or 
procedure  file. 

DISPLAY_OBJECT_TEXT 

Display  object  records  of  an  object  library  or  file. 

EDIT_DECK 

(SCU  subcommand)  Open  a  deck  in  the  working  library  for 
editing  while  maintaining  your  current  position  in  other  decks. 

EXPAND_SOURCE_F I LE 

Expand  a  text  file  as  though  it  were  a  deck  in  an  SCU  library. 
EXTRACT_SOURCE_LIBRARY 

Extract  decks  from  a  base  library  to  use  as  a  separate 
1 ibrary. 
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FORMAT_SCL_PROCEDURE 

Format  a  file  of  SCL  commands  to  improve  readability. 
GENERATE_SCU_EDI T_COMMANDS 

Compare  a  deck  and  a  text  source  file  and  generate  editing 
commands  to  make  the  deck  match  the  source  file. 

SOURCE_CODE_UTILITY 

Begin  an  SCU  utility  session. 

***  Programming  Languages  *** 

BASIC  Compile  a  BASIC  source  program. 

COBOL  Compile  a  COBOL  source  program. 

FORTRAN  Compile  a  Fortran  program. 

FTN  (same  as  FORTRAN) 

PASCAL  Compile  a  PASCAL  program. 

***  Loader  and  Loader-related  Control  Statements  *** 

EXECUTE_TASK 

Execute  a  program. 

SLOCAL.LGO  Load  and  execute  the  default  compiler  binary  output  file. 

name  Load  and  execute  binary  program  or  procedure  in  your 

command  list. 

pathname  Load  and  execute  binary  program  or  procedure  in  the 

specified  file 

***  Combination  *** 

FLR  (DTRC)  Compile  FTN5,  load  with  optional  libraries,  and  run. 

***  Variables  *** 

CREATE_DEFAULT_VARIABLE 

Create  an  environment  variable  to  be  used  as  a  default. 
CREATE_F1LE_VARIABLE 

Create  an  environment  variable  of  type  FILE. 

DELETE_VARIABLE 

Delete  variables  accessible  from  the  current  block. 
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DISPLAY_VALUE 

Display  the  value  of  an  expression. 

DISPLAY_VARIABLE_LIST 

Display  variables  accessible  to  the  current  block. 

GET_t  I\>: 

Read  a  line  from  a  file  into  a  string  variable. 

POP  Delete  the  current  version  of  an  environment  object  or 

variable  and  restore  to  its  former  value. 

PUSH  Temporarily  change  environment  objects  or  variables  in  an 
SCL  procedure. 

SHOW_VALUE 

Display  a  value  in  a  pop  up  window. 

TYPE  Create  one  or  more  user-defined  data  types. 

VAR  Create  one  or  more  variables. 

***  Miscellaneous  *** 

AUXPRINT  (DTRC)  Print  a  file  on  your  auxiliary  printer  (the  one 
attached  to  your  terminal. 

ENCRYPT_FILE 

Encrypt  a  file  using  the  National  Bureau  of  Standards  Data 
Encryption  Standard  algorithm. 

ENTER_PROGRAMMING_ENVIRONMENT 

Access  the  Programming  Environment. 

FICHE  (DTRC)  Print  a  NOS/VE  file  on  microfiche  (COM). 

NEWS  (DTRC)  Display  the  current  news  file  or  copy  it  into  a  user 

file. 

NEW_ROUTINES 

(DTRC)  Display  a  description  of  recently-added  routines  or 
copy  the  information  into  a  user  file. 

0LD_NEWS 

(DTRC)  Display  the  old  news  file  or  copy  it  into  a  user  file. 

RATES  (DTRC)  Display  the  current  Computer  Center  rates  or  put  them 
into  a  user  file. 

SELECT_USER_MENU 

Begin  the  NOS/VE  user  menu  system. 

SEND_OPERATOR_MESSAGE 

Send  a  message  to  an  operator. 
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WHO 

WHO AM I 

XFPOX 


(DTRC)  List  the  executing  jobs,  including  users  currently 
logged  in, 

(DTRC)  Display  the  executing  user's  username  and  job  order 
number . 

(DTRC)  Print  a  NOS/VE  file  on  the  Xerox  8700. 
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*****  Editing  Files  ***** 

Files  are  created  and  edited  throught  the  EDIT_FILE  utility.  This 
is  a  screen  or  line  mode  editor  depending  on  the  interaction  style  set 
for  your  session.  It  is  in  line  mode  by  default.  There  are  various 
commands  available  that  will  allow  you  to  make  changes  to  the  text  you 
are  working  with.  The  keypad  layout  for  the  DEC_VT100_GOLD  terminal 
definition  is  on  page  8-1-3. 

The  zero  key  followed  by  the  number  key  on  the  keypad  performs  the 
functions  indicated  by  capital  letters.  The  remaining  functions  are 
performed  by  pressing  the  keypad  numeric  key  by  itself.  The  cursor 
keys  will  position  the  cursor  where  you  want.  EDIT_FILE  is  like  FSE  in 
that  the  'home  line'  is  where  line  mode  commands  are  entered.  Also, 
this  is  where  you  enter  the  'QUIT1  command.  Unlike  other  editors,  QUIT 
exits  the  editor  and  saves  the  file  (keypad  6  by  itself) .  In  order  to 
exit  without  saving,  you  must  enter  QUIT  WF=T  (or  keypad  0  +  keypad  6). 
All  commands  entered  from  the  keypad  must  be  followed  the  ENTER  key. 
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*****  Message  L  Help  Libraries  ***** 

A  message  module  contains  information  for  use  during  command  entry 
and  error  processing.  The  CREATE_MESSAGE_MODULE  utility  is  used  to 
maintain  message  modules.  When  used  within  CREATE_0B JECT_LIBRARY  (see 
Section  8-6),  you  can  create  command  helps,  parameter  helps,  and 
status  messages. 


***  The  CREMM  Command  *** 


CREATE  MESSAGE  MODULE 


Begin  a  CREATE_MESSAGE_MODULE  utility  session. 

Syntax:  CREATE_MESSAGE_MODULE  ~or~ 

CREMM 

N  or  NAME=program_name 


M  or  MANUAL=program_name 

NL  or  NATURAL_LANGUAGE=keyword  or  name 

MO  or  MERGE_OPTION=keyword 

STATUS=status  variable 

Parameters:  N  -  the  name  of  the  message  module  in  the  form 

name$ language 

where  name  is  the  name  of  the  procedure 

language  is  US_ENGLISH 

M  -  the  name  of  the  on-line  manual  which 
describes  the  command  or  function 

NL  -  the  natural  language  of  the  message 
(default:  US$ENGLISH) 

MO  -  merge  options 

ab  option  meaning 


A  ADD  add  to  the  library 

R  REPLACE  replace  existing  module 

C  COMBINE  replace  if  existing,  else  add 
(default:  C) 

Subcommand  prompt:  CMM/ 

Similar  commands:  NOS: 

VMS:  LIBRARY 


Examples : 


/ creoi 
COL/ cremm 
CMM/ 
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***  CREMM  Subcommands  *** 

The  following  CREMM  subcommands  are  used  to  create  messages. 


CREATE_BRIEF_HELP_MODULE 

Create  a  brief  description  of  a  command. 

Syntax:  CREATE_BRIEF_HELP_MODULE  -or- 

CREBHM 


CTU  or  COLLECT_TEMPLATE_UNTIL=str ing 
STATUS=s tatus  variable 

Parameters:  CTU  -  the  string  which  terminates  the  message 

(default:  '**') 

See  also:  CREATE_FULL_HELP_MODULE 

Examples:  CMM/crebhm 

?  The  MSFETCH  command  fetches  a  file  from 
?  the  Mass  Storage  System. 

7  Vc  * 

CMM/ 


CREATE_FULL_HELP_MESSAGE 

Create  a  full  description  of  a  command. 

Syntax:  CREATE_FULL_HELP_MODULE  -or- 

CREFHM 


CTU  or  COLLECT_TEMPLATE_UNTIL=string 
STATUS=status  variable 

Parameters:  CTU  -  the  string  which  terminates  the  message 

(default:  '**') 

See  also:  CREATE_BRIEF_HELP_MODULE 

Examples:  CMM/crebhm 

?  The  MSFETCH  command  fetches  a  file  from 
?  the  Mass  Storage  System.  You  can  give  it 
?  a  different  name  on  NOS/VE  or  let  it  have 
?  its  NOS  name. 

7  ** 

CMM/ 
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CREATE_PARAMETER_ASSIST_MESSAGE 

Create  a  message  to  be  displayed  when  the  user  enters  an 
incorrect  parameter  value. 

Syntax:  CREATE_PARAMETER_ASSIST_MESSAGE  -or- 

CREPAM 

N  or  NAME=name 


CTU  or  COLLECT_TEMPLATE_UNT I L=  s t r i ng 
STATUS=s tatus  variable 

Parameters:  N  -  the  name  of  the  parameter 

(if  the  command/procedure  has  aliases,  this 
must  be  the  first  name  listed  in  the  PDT  or 
PROCEDURE  statement) 

CTU  -  the  string  which  terminates  the  message 
(default:  '**') 

See  also:  CREATE_PARAMETER_HELP_MESSAGE 

Examples:  CMM/crepam  name=mfn 

?  Enter  the  name  of  the  MSS  file  you  are 
?  fetching.  It  must  be  1-7  alphanumeric 
?  characters. 

7  ** 

CMM/ 


CREATE_PARAMETER_HELP_MESSAGE 

Create  a  message  to  be  displayed  when  the  user  requests  help 
for  the  specified  parameter. 

Syntax:  CREATE_PARAMETER_HELP_MESSAGE  -or- 

CREPHM 

N  or  NAME=name 


CTU  or  COLLECT_TEMPLATE_UNTIL=string 
STATUS=status  variable 

Parameters:  N  -  the  name  of  the  parameter 

(if  the  command/procedure  has  aliases,  this 
must  be  the  first  name  listed  in  the  PDT  or 
PROCEDURE  statement) 

CTU  -  the  string  which  terminates  the  message 
(default:  '**') 

See  also:  CREATE_PARAMETER_ASSIST_MESSAGE 

CMM/crephm  mfn 

?  The  MFN  parameter  is  the  name  of  the  MSS  file 
?  you  are  fetching.  It  must  be  1-7  alphanumeric 
?  characters. 

7  A* 

CMM/ 


Examples : 
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CREATE_PARAMETER_PROMPT_MESSAGE 

Create  the  prompt  message  for  the  specified  parameter. 

Syntax:  ChEATE_PARAMETER_PROMPT_MESSAGE  -or- 

CREPPM 

N  or  NAME=name 


CTU  or  COLLECT_TEMPLATE_UNTIL=str ing 
STATUS=status  variable 

Parameters:  N  -  the  name  of  the  parameter 

(if  the  command/procedure  has  aliases,  this 
must  be  the  first  name  listed  in  the  PDT  or 
PROCEDURE  statement) 

CTU  -  the  string  which  terminates  the  message 
(default:  '**') 

See  also:  CREATE_PARAMETER_ASSIST_MESSAGE 

Examples:  CMM/creppm  .. 

CMM. . /name=mfn 
?  MSS  filename? 

•>  ** 

CMM/ 

CREATE_STATUS_MESSAGE 

Create  a  status  message  for  the  specfied  status  condition  code. 

Syntax:  CREATE_STATUS_MESSAGE  -or- 

CRESM 

N  or  NAME=name 

C  or  CODE=integer 


I  or  IDENTIFIER=string 
S  or  SEVERITY=keyword 
CTU  or  COLLECT_TEMPLATE_UNT IL=string 
STATUS=s tatus  variable 

Parameters:  N  -  the  condition  identifier 

C  -  the  status  condition  code 

(range:  10000-19999;  numbers  above  and 

below  this  rqnge  are  reserved  for 
NOS/VE) 

I  -  2-character  product  identifier 

S  -  the  severity  level  of  the  status  condition 
ab  option 

NS  NON_STANDARD 
D  DEPENDENT 
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Examples : 


I  INFORMATIVE 
W  WARNING 
E  ERROR 
F  FATAL 
C  CATASTROPHIC 
(default:  ERROR) 

CTU  -  the  string  which  terminates  the  message 
(default:  '**') 

Change  the  message  for  CLE$UNKNOWN_COMMAND  from 
"<text>  is  not  a  command."  to  "The  command  <text> 
is  not  in  your  command  list." 

/display_value  .. 

. . /$status_code_s  tr ing (cle$unknown_command) 

CL  790 
/creol 

COL/cremm  show 

CMM/cresm  name=cle$unknown__command  code=790  .. 
CMM/i='CL'  s=error 

?  The  comand  +P  is  not  in  your  command  list. 

7  ?V 

CMM/ quit 

COL/genl  my_messages 
COL/quit 

/create_command_list_entry  mymessages 
. . /p=before 

/ wha  t_am_i_do ing 

— ERROR —  The  command  WHAT_AM_I_DOING  is  not 
in  your  command  list. 

/ 
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END_MESSAGE_MODULE 

End  the  CREMM  session. 


Syntax : 


END_MESSAGE_MODULE  -or- 
ENDM  -or- 
QU IT  -or- 
QUI 


CM  or  CREATE_MODULE=bool ean 
STATUS=s tatus  variable 


Parameters:  CM  -  specify  whether  message  module  is  to  be 

created 
(default:  YES) 


See  also:  CREATE_MESSAGE_MODULE 

Examples:  /creol 

COL/cremm 

CMM/<do  your  thing> 
CMM/endmm 
COL/quit 
/ 
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***  The  Message  Text  *** 

The  message  text  fellows  each  CREATE_*_MESSAGE  subcommand  and 
terminates  when  <ctu>  is  encountered  on  a  separate  line.  The  text  is 
really  a  template  which  is  processed  into  the  message  that  is  displayed. 
Unless  otherwise  indicated,  the  text  is  displayed  as  a  single  paragraph 
with  the  last  non-blank  concatenated  with  the  first  position  of  the 
r..  xt  line.  Thus,  it  you  end  with  a  complete  word,  you  must  start  the 
next  line  with  a  blank.  To  put  two  blanks  between  sentences,  start  the 
sentence  on  a  new  line  preceded  by  two  blanks.  Otherwise,  multiple 
blanks  are  compress  to  a  single  blank 

Control  sequences  are  used  to  format  the  message.  A  control 
sequence  is  indicated  by  a  plus  sign  (+)  and  is  used  for  parameter 
substitution,  horizontal  positioning,  and  insertion  of  portions  of  the 
condition  record. 


Parameter  Substitution 


Control  sequence 

Description 

+Pn 

Substitute  the  nth  command  parameter  (1  <=  n  <=  128) 
(for  status  messages,  the  parameters  are  taken  from 
the  text  field  of  the  status  record). 

+  P 

Substitute  the  next  command  parameter. 

+  Fn 

Substitute  the  nth  message  parameter  and  expand  it 
to  a  filepath. 

+  F 

Substitute  the  next  message  parareter. 

**  Horizontal  Posit-'oning  ** 

Control  sequence 

Description 

+N 

Start  a  new  line. 

+Nn 

Start  a  new  line  and  indent  n  spaces. 

+  E 

If  the  current  output  line  becomes  too  long,  start  a 
new  line. 

+En 

Same,  but  indent  n  spaces. 

+Xn 

Put  n  spaces  into  the  text  (default:  1).  This  is 
required  to  insert  two  or  more  contiguous  spaces. 

+Kt  ext+K 

The  bracketed  text  is  put  onto  a  single  line,  if 
possible. 

+Hn 

Horizontal  fab  to  column  n.  If  line  becomes  too 
long,  start  a  new  line  with  no  leading  blanks. 

+H 

Tab  to  the  next  default  tab  (1,  9,  17,  25,  ...). 

**  Miscellaneous  ** 

Control  sequence 

Descripti  ->n 
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++  Insert  a  single  plus  character.  (not  needed  if  the 

character  following  the  plus  is  not  a  control 
character) 

+-  Do  nothing  —  used  to  concatenate  a  message 

parameter  with  following  text  without  intervening 
blanks  —  most  often  used  with  a  number  might  be 
interpreted  as  part  of  the  control  sequence,  e.g., 
"+H9+-9)  some  text". 

+R  The  remainder  of  the  template  is  repeated  until 

there  are  no  more  +P  or  +F  control  sequences. 

+R  may  be  used  only  once  in  a  template. 


Status  Record  Fields 


The  following  control  sequences  are  used  only  with  status  messages: 
Control  sequence  Description 


+C  Insert  the  condition  field  in  the  format  "XX  n" 

where  XX  is  the  product  identifier  and  n  is  the 
numeric  part  (0-16,777,215) 

+I  Insert  the  product  identification  part  of  the 

condition  code 
Insert  the  security  level 
Insert  the  entire  text  field 


+S 

+T 
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***  Sample  Helps 


s’cVcVc 


1)  The  procedure  Fortran_Load_Run  has  the  following  header: 


PROCEDURE  (help_flr)  Fortran_Load_Run,  fir  ( 

input,  i  :  file  =  $required 
library,  libraries,  1  :  list  of  file  =  Soptional 
parameter,  parameters,  p  :  list  of  file  =  Soptional 
status  ) 


Create  HELP_FLR: 

/creol 

COL/cremm  help_f lr$us_english 
CMM/  Create_Brief_Help_Message 

CMM/This  commands  compiles,  loads  with  optional  libraries, 

CMM/  and  executes  a  Fortran  program. 

CMM/** 

CMM/  Create_Ful l_Help_Message 

CMM/This  commands  compiles,  loads,  and  executes  a  Fortran  program. 
CMM/  You  may  specify  one  or  more  object  libraries  to  be  searched 
CMM/  while  loading  the  program. 

CMM/** 

CMM/  Create_Parameter_Prompt_Message  input 
CMM/ Input  file? 

CMM/** 

CMM/  Create_Parameter_Help_Message  input 

CMM/The  INPUT  parameter  specifies  the  file  with  the  input  Fortran 
CMM/  source  program. 

CMM/** 

CMM/  CreateParameterAssistMessage  input 

CMM/Enter  the  name  of  the  file  with  the  input  FOrtran  source 

CMM/  program. 

CMM/** 

CMM/Create_Parameter_Prompt_Message  library 
CMM/Library  file(s)? 

CMM/** 

CMM/Create_Parameter_Help_Message  1 ibrary 

CMM/The  LIBRARY  parameter  specifies  the  libraries  to  be  used  in 
CMM/  loading  the  program. 

CMM/+N0lf  omitted,  no  libraries  will  be  used. 

CMM/** 

CMM/Create_Parameter_Assist_Message  library 
CMM/Enter  the  name  of  the  file  to  receive  the  output. 

CMM/+N00r,  press  RETURN  to  use  no  libraries. 

CMM/** 

CMM/Create_Parameter_Prompt_Message  parameter 
CMM/ Parameters? 

CMM/** 

CMM/Create_Parameter_Help_Message  parameter 
CMM/The  PARAMETER  parameter  specifies  the  parameters  for  the 
CMM/  program  (to  replace  files  in  PROGRAM  statement  list). 
CMM/+N0lf  omitted,  no  parameters  will  be  passed  to  the  program. 
CMM/** 

CMM/Create_Parameter_Ass ist_Message  parameter 
CMM/Enter  the  parameters  for  the  program. 
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CMM/+NOIf  omitted,  no  parameters  will  be  passed  to  the  program. 

cm/** 

CMM/Quit 

COL/geni  my_neip_l ibrary 
COL/ quit 
/ 

Alternatively,  the  lines  above  beginning  with  CMM/  could  be  put  into 
a  file  (without  "CMM/")  and  the  file  (e.g.,  FLR_HELP)  included: 

/ creol 

COL/include_f ile  flr_help 
COL/genl  my_help_l ibrary 
COL/ quit 
/ 


i 
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2)  The  procedure  MSFETCH  has  the  following  header: 

procedure  (help_ms fetch)  MSFcaCH  ( 

from,  f,  mfn  :  name  =  $required 

to,  t  :  file  =  $optional 

data_conversion,  dc  :  key  B60  B56  A6  A8  D63  D64 

keyend  =  B56 

status  ) 

The  help  for  MSFETCH  is  called  HELP_MSFETCH  and  is  in  file 
MSFETCH_HELP : 

(  1)  Create_Message_Module  help_msf etch$us_english 
(  2)  "  MSFETCH 

(  3)  Create_Brief_Help_Message 
(  4)  This  fetches  a  file  from  the  MSS. 

(  5)  ** 

(  6)  Create_Full_Help_Message 

(  7)  This  fetches  one  of  your  files  from  the  Mass  Storage  System. 

(  8)  ** 

(  9)  "  FROM 

(10)  Create_Parameter_Prompt_Message  from 

(11)  MSS  Filename? 

(12)  ** 

(13)  Create_Parameter_Help_Message  from 

(14)  The  FROM  parameter  specifies  the  MSS  file  to  be  fetched. 

(15)  ** 

(16)  Create_Parameter_Assist_Message  from 

(17)  Enter  the  name  of  the  MSS  file  to  be  fetched. 

(18)  ** 

(19)  "  TO 

(20)  Create_Parameter_Prompt_Message  to 

(21)  NOS/VE  filename? 

(22)  ** 

(23)  Create_Parameter_Help_Message  to 

(24)  The  TO  parameter  specified  the  NOS/VE  name  for  the  file. 

(25)  ** 

(26)  Create_Parameter_Assist_Message  to 

(27)  Enter  the  NOS/VE  name  for  the  file. 

(28)  Or  press  return  to  use  the  MSS  filename. 

(29)  ** 

(30)  "  DATA_CON VERS ION 

(31)  Create_Parameter_Prompt_Message  data_conversion 

(32)  DC= 

(33)  ** 

(34)  Create_Parameter_Help_Message  data_conversion 

(35)  The  DATA_C0NVERSI0N  (DC)  parameter  specifies  the  character 

(36)  code  conversion  to  be  performed  during  the  transfer  (B60, 

(37)  [  B56  ] ,  A 6,  A8 ,  D63,  D64) . 

(38)  ** 

(39)  Create_Parameter_Ass ist_Message  data_conversion 

(40)  Enter  one  of  the  following  data  conversion  codes: 

(41)  +N0B60  (NOS  word  — >  rightmost  60  NOS/VE  bits; 

(42)  leftmost  4  NOS/VE  bits  set  to  0) 

(43)  +N0B56  (rightmost  56  NOS  bits  — >  contiguous  NOS/VE  bits; 

(44)  leftmost  4  NOS  bits  ignored  (use  for  NOS/VE  object  libraries 
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(45)  SCU  libraries,  permanent  file  backup  files)) 

(46)  +N0A6+X2 (NOS  6/ 12  display  code  — >  7-bit  ASCII) 

(47)  +N0A8+X2 (NOS  8/12  display  code  — >  7-bit  ASCII) 

(48)  +N0D63  (NOS  63-char  display  code  — >  7-bit  ASCII) 

(49)  +N0D64  (NOS  64-char  display  code  — >  7-bit  ASCII) 

(50)  +N00r,  press  RETURN  for  B56. 

(51)  ** 

(52)  Quit 

where 


1 

2 

3-5 

6-8 

9 

10-12 

13-15 

16-18 

19-29 

30-51 

52 


specifies  the  name  and  language 
a  comment  to  help  locate  things  while  editing 
the  brief  help  message 
the  full  help  message 

a  comment  to  help  locate  the  FROM  parameter  helps 

the  prompt  message  for  the  FROM  parameter 

the  help  message  for  the  FROM  parameter 

the  assist  message  for  the  FROM  parameter 

like  9~18  for  the  TO  parameter 

like  9-18  for  the  DATA_CONVERSION  parameter 

terminate  the  CREMM 


Create  HELP_MSFETCH : 

/creol 

COL/addm  my_help_l ibrary  < — 

COL/include_f i le  msfetch_help  < — 
COL/delcle  my_help_l ibrary  < — 

COL/genl  myhelpl ibrary . $next< — 
COL/quit 

/crecle  myhelpl ibrary  < — 

/ 


if  MY_HELP__LIBRARY  already 
has  modules  in  it 
replaces  or  adds  HELP_MSFETCH 
remove  the  library  from  your 
command  list 

creates  a  new  cycle  of  your 
library  ($NEXT  is  needed  if  the 
library  is  in  your  command  list) 

restore  to  your  command  list 
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3) 


SUBMIT_CRAY_JOB  displays  the  message 

Job  sent  to  NOS  Cray  Station  at  hh:mm:ss 


when  the  job  has  been  sent.  The  status  message  module  which  does 
this  is: 

1  -  CREAT E_MES  S AGE_M0DU LE  NAME=CRM$MESSAGE_TEMPLATE_MODULE  . . 

2  -  NATURAL_LANGUAGE=US_ENGL I SH 

3  -  CREATE_STATUS_MESSAGE  NAME=CRE$ J0B_SENT_T0_N0S_CRAY_STA  . . 

4-  IDENTIFIERS CR'  CODE=10004  SEVERITY= INFORMATIVE  .. 

5  -  COLLECT_TEMPLATE_UNTIL= ' ** 1 

6  -  Job  sent  to  NOS  Cray  Station  at  +P 

7  _  ** 

8  -  END  MESSAGE  MODULE  CREATE  MODULE=YES 


The  procedure  SUBCJ  terminates  with 

EXIT  procedure  WITH  Sstatus (false ,  'CR',  10004,  Stime(hms)) 

The  +P  in  line  6  of  the  module  is  replaced  by  the  value  of  Stime(hms) 
in  the  SSTATUS  function. 
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*****  Procedures  and  Functions  ***** 

A  procedure  or  function  is  a  group  of  control  statements  separate 
from  the  job  control  statement  file.  Calling  a  procedure  provides  a 
simplified  way  to  process  that  group  of  control  statements.  A  procedure 
may  be  called  by  a  job  repeatedly,  by  another  procedure,  or  by  itself. 

A  function  returns  a  value  to  the  caller. 


***  Procedure  and  Function  Commands  *** 

A  procedure  begins  with  a  PROCEDURE  statement,  which  defines  the 
procedure's  names,  attributes,  and  parameters,  and  ends  with  PROCEND. 

A  function  begins  with  a  FUNCTION  statement,  which  defines  the 
function's  names,  attributes,  and  parameters,  and  ends  with  FUNCEND. 
Functions  names  begin  with  a  dollar  sign  ($) . 

All  commands,  functions,  utilities,  and  statements  in  the  command 
list  are  available  in  procedures  and  functions.  The  following  commands 
are  used  in  writing  them  (see  Appendix  H  for  syntax): 

COLLECT_TEXT  Read  text  lines  from  a  file  or  the  command  stream 

into  a  file. 

DELETE_VARIABLE  Delete  variables  from  the  current  block. 

DISPLAYVALUE  Display  the  value  of  an  expression. 

DISPLAY_VARIABLE_LIST  Display  the  variables  available  to  the  job. 
FORMAT_SCL_PROCEDURE  Format  a  procedure  and  detect  errors. 

GET_LINE  Read  lines  from  a  file  into  a  string  variable. 

INCLUDE_COMMAND  Create  and  execute  a  command. 

INCLUDE_FILE 
INCLUDE_LINE 
PUT_LINE 
TYPE/TYPEND 
VAR/VAREND 
WHEN/WHENEND 
WAIT 


Execute  a  file  of  commands. 

Execute  a  string  of  commands. 

Write  lines  from  string  variables  into  a  file. 
Create  an  SCL  data  type. 

Create  an  SCL  variable. 

Execute  statments  on  specified  condition. 

Suspend  processing  for  a  specified  time  or  until 
an  event  or  set  of  events  occurs. 
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***  Procedure  and  Function  Libraries  *** 

CREATE_OB JECT_LIBRARY  (creol)  is  a  utility  for  creating  and 
maintaining  object  libraries  of  load  modules,  function  modules,  SCL 
procedure  modules,  and  message  modules.  CREOL  uses  a  module  list 
while  processing  its  subcommands.  Your  library  is  not  modified  until 
you  generate  a  new  library. 

This  section  discusses  SCL  procedure  and  functions  libraries.  See 
section  8~6  for  object  libraries;  and  8~3  for  message/help  libraries. 


***  Subcommands  *** 

The  following  CREOL  subcommands  are  used  to  maintain  libraries  of 
procedures  and  functions.  They  are  described  in  detail  in  Section  8-6. 

ADD_MODULE 

Add  one  or  more  modules  to  the  module  list. 

COMB INE_MODULE 

Add  or  replace  modules  in  the  module  list. 

DELETE_MODULE 

Delete  one  or  more  modules  from  a  module  list. 
DISPLAY_NEW_LIBRARY 

Display  the  contents  of  the  module  list. 

GENERATE_LIBRARY 

Generate  a  new  object  library  containing  the  modules  in  the 
module  list.  It  can  also  write  an  object  file,  SCL  procedure 
text  file,  form  source  file,  form  variable  file,  or  CREATE_ 
MESSAGE_MODULE  subcommands. 

QUIT  End  a  CREATE_0B JECT_LIBRARY  utility  session. 

RE0RDER_M0DULE 

Reorder  modules  in  the  module  list. 

REPLACE_MODULE 

Replace  modules  in  the  module  list. 

SET_DISPLAY_OPTION 

Change  and  display  the  default  display  options  for  DISPLAY_ 
NEW  LIBRARY. 
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***  DTRC  Procedure  /  Function  Library  *** 

Public-access  procedure/function  library  PROCLIB  has  been  added  to 
each  user's  command  list  at  DTRC. 

The  following  are  the  public  procedures  and  functions  available  at 
DTRC  as  of  the  date  of  this  page.  For  the  current  list,  type  "HELP 
CONTENTS  CCRM".  See  Appendix  H  for  further  information  on  individual 
procedures  and  functions. 

ANY_MAIL  Check  for  mail  and,  optionally,  list  the  letters. 

AUXPRINT  Print  a  file  on  your  auxiliary  printer. 

DELETE_ALL_CYCLES 

Delete  all  cycles  of  one  or  more  files. 

ECHO  Turn  echo  file  on  or  off. 

FICHE  Route  a  copy  of  a  local  file  to  the  microfiche  (COM). 

MSACCES  Access  the  Mass  Storage  System. 

MSAUDIT  Sorted  list  of  MSS  files. 

MSCATLIST  The  complete  NOS  CATLIST  command. 

MSCHANG  Change  attributes  of  an  MSS  file. 

MSFETCH  Fetch  a  file  from  the  MSS. 

MSPASSW  Change  your  MSACCES  password. 

MSPURGE  Purge  an  MSS  file. 

MSSTORE  Store  a  file  on  the  MSS. 

NEWS  Display  the  current  news. 

NEW_ROUTINES  Announcement  of  new  routines. 

OLD_NEWS  Display  the  old  news. 

PURGE  Delete  all  cycles  except  the  specified  number  of  highest 

cycles . 

RATES  Display  the  current  computer  rates. 

SET_DEFAULT_LOGIN_PROJECT 

Set  your  Default  Login  Project  Number  so  it  can  be 
omitted  in  future  logins. 

STATUS_CRAY  Display  the  status  of  the  Cray  queues. 


SUBMIT  CRAY  JOB 
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XEROX 
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Submit  a  job  to  the  Cray  via  the  NOS  Cray  Station. 

Display  a  list  of  the  executing  jobs  (including  logged-in 
users . 

Display  your  User  Initials  and  account  number. 

Route  a  copy  of  a  local  file  to  the  Xerox  8700. 
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***  Sample  Procedures  ’•'** 

1)  Compile  and  optionally  execute  a  Fortran  program,  optionally  using 
libraries  of  subprograms: 

(  1)  PROCEDURE  (help_flr)  Fortran_Load_Run,  fir  ( 

(  2)  input,  i  :  file  =  $required 

(  3)  library,  libraries,  1  :  list  of  file  =  $optional 

(  4)  parameter,  parameters,  p  :  list  of  file  =  Soptional 

(  5)  status  ) 

(  6)  "FLR  Compile  Fortran,  load  with  optional  libs  and  run" 

(  7)  "  Echo  execute  statement  with  substitution 

(  8)  " 

(  9)  Collect_Text  output=$output  subs ti tut i on_mark=’ ? 1 

(10)  until-’**' 

(11)  FLR  I=?i?  LIBRARY=? library?  PARAMETER=?parameter? 

(12)  ** 

(13)  "  Compile  Fortran 

(14)  " 

(15)  Include_Line  'Fortran  1= ' //$s tring  (i) // '  L=$NULL' 

(16)  "  Link  with  optional  libraries  and  execute 

(17)  " 

(18)  Execute_Task  P=parameters  L=library 

(19)  Exit  Fortran_Load_Run 

(20)  "  created  1990/05/21  by  AMDS 

(21)  "  last  modified  1990/05/21  <?  1310  by  AMDS 

(22)  PROCEND  Fortran_Load_Run 
Explanation: 

(1-5)  procedure  header 

(I)  Defines  the  help  module  name,  and  procedure  name 
and  aliases 

(2-4)  Defines  the  parameters,  their  aliases  and  types 
(5)  The  STATUS  parameter  should  always  be  the  last 
parameter 

(6)  A  comment  describing  what  the  procedure  does 

(7-12)  Echoing  the  command  to  the  terminal  substituting  user 
values  for  the  parameters 
(7-8)  Comments 
(9-10)  The  COLT  command 

(II)  The  display  with  the  strings  delimited  by  "?" 
to  be  replaced  by  the  execution  values 

(12)  The  end-of-file  for  COLT 
(13-15)  Creates  the  FORTRAN  command  and  executes  it 

(INCLUDE_C0MMAND  could  also  have  been  used  here) 

(16-18)  Loads  and  executes  the  object  module  created  by  the 
compiler 

(19)  Leave  the  procedure  (if  the  procedure  name  is  specified. 
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(20- 

(22) 


2)  Fetch 

(  1) 
(  2) 
(  3) 
(  4) 
(  5) 
(  6) 

(  7) 

(  8) 
(  9) 
(10) 
(ID 
(12) 

(13) 

(14) 

(15) 

(16) 

(17) 

(18) 

(19) 

(20) 
(21) 
(22) 

(23) 

(24) 

(25) 

(26) 

(27) 

(28) 

(29) 

(30) 

(31) 

(32) 

(33) 

(34) 

(35) 

(36) 

(37) 

(38) 

(39) 

(40) 

(41) 


it  must  be  the  first  name  in  line  1) 

21)  The  history  of  the  procedure 

The  end  of  the  procedure  (if  the  procedure  name  is 
specified,  it  must  be  the  first  name  in  line  1) 


a  file  from  the  Mass  Storage  System: 

procedure  (help_ms fetch)  MSFETCH  ( 

from,  f,  mfn  :  name  =  $required 

to,  t  :  file  =  Soptional 

data_conversion,  dc  :  key  B60  B56  A6  A8  D63  D64 

keyend  =  B56 

status  ) 

"MSFETCH  Fetch  a  file  from  the  MSS" 

"  Echo  execute  statement  with  substitution 

H 

Collect_Text  o=$output  sm= ' ? '  u='**' 

MSFETCH  FROM=?f rom?  TO=?to?  DC=?data_conversion? 

** 


"  Validate  FROM= 

M 

if  Sspecif ied(from)  then 

from_file  =  Sstring (f rom) 
if  $size(from_file)  >  7  then 

Put_Line  '  MSFETCH  FROM=  filename  too  long 
7  alphanumeric  characters  maximum  \ ' //f rom_f i le// ' \ ' 
exit  MSFETCH 
ifend 
if  end 

"  Get  the  file 
!» 

Get_File  to=$parameter_value (to)  .. 

f rom=$parameter_value (f rom)  .. 

data_convers ion=$parameter_value (data_convers ion) 
"  Closing  message 

M 

Collect_Text  Soutput  '?'  'close_end' 

File  ?from?  fetched  from  MSS  as  file  ?to? 

using  DC=?data_convers ion? 
close_end 

Exit  MSFETCH 

"  created  1990/03/27  by  AMDS 
"  modified  1990/03/27  @  1112  by  AMDS 

"  modified  1990/03/28  @  1348  by  AMDS  (remove  fault  trap) 

"  last  modified  1990/03/30  <?  0908  by  AMDS  (add  MFN  as 
"  synomym  for  FROM; 

"  remove  MFN  as 

"  synonym  for  TO) 
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(42)  PROCEND  MSFETCH 
Explanation: 

(1-6)  Procedure  header 

(I)  Defines  the  help  module  and  procedure  names 
(2-5)  Defines  the  parameters,  their  aliases,  types, 

and  acceptable  values 

(6)  The  STATUS  parameter  should  always  be  the  last 

parameter 

(7)  A  comment  describing  what  the  procedure  does 
(8-12)  Echoing  the  command  to  the  terminal  substituting  user 
values  for  the  parameters 
(8~9)  Comments 

(10)  The  COLT  command 

(II)  The  display  with  the  strings  delimited  by  "?" 
to  be  replaced  by  the  execution  values 

(12)  The  end-of-file  for  COLT 

(13~22)  Code  to  validate  the  FROM  parameter 
(13-14)  Comments 

(15/22)  Encloses  code  to  be  executed  if  the  FROM  parameter 
was  specified 

(16)  Convert  the  parameter  to  a  string  for  later  use 
(17/21)  Encloses  code  to  be  executed  if  the  value  is  too 
long 

(18-19)  Display  the  error  message 
(20)  Leave  the  procedure 

(23-27)  Code  to  get  the  file  from  NOS 
(28-33)  Closing  message 
(34)  Leave  the  procedure 

(35-41)  The  history  of  the  procedure 
(42)  The  end  of  the  procedure 
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***  Sample  Function  *** 

1)  The  following  function  is  used  by  procedure  FILES  to  analyze  the 
user's  specified  DEPTH  parameter  and  return  0  (error),  a  valid 
depth  value,  or  the  default  value. 

(  1)  function  $f iles_set_depth  ( 

(  2)  depth  :  integer  0..3 

(  3)  max_depth  :  integer  2.. 3 

(  A)  def aul t_depth  :  integer  2.. 3 

(  5)  ) 

(  6)  "$FILES_SET_DEPTH  -  set  the  depth  to  specified  value" 

(  7)  "  or  default" 

(  8)  IF  depth  >  max_dopth  THEN 
(  9)  the_depth  =  0 

(10)  ELSEIF  depth  =  0  THEN 

(11)  the_depth  =  def aul t_depth 

(12)  ELSE 

(13)  the_depth  =  depth 

(14)  IFEND 

(15)  EXIT  $f i lessetdepth  WITH  the_depth 

(16)  "  created  1990/05/16  by  AMDS 

(17)  "  last  modified  1990/05/16  @  080A  by  AMDS 

(18)  FUNCEND  $f i 1 essetdepth 

Explanation: 

(1-5)  function  header 

(1)  defines  the  function  name 

(2)  defines  DEPTH  paremeter  as  a  required  integer  with 
valid  values  of  0,  1,  2,  3 

(3)  defines  MAX_DEPTH  as  a  required  integer  with  valid 
values  2  or  3 

(A)  defines  DEFAULT_DEPTH  similarly 
(5)  end  of  function  header 
(6“7)  A  comment  describing  what  the  function  does 
(8~1A)  Define  variable  THE_DEPTH  as  0  (error) ,  the  default  (input 
value  is  0),  or  the  specified  depth) 

(15)  Exit  from  the  procedure  returning  THE_DEPTH  as  the 
function's  value 

(16~17)  The  history  of  the  procedure 

(18)  The  end  of  the  function  (if  the  function  name  is 
specified,  it  must  be  the  first  name  in  line  1) 

The  FILES  procedure  uses  this  function  as  follows: 

(1)  the_depth  =  $f i les_set_depth (depth , 2 , 2) 

(2)  IF  thedepth  =  0  THEN 

(3)  EXIT  files  WITH  Sstatus  (false,  'US',  1,  .. 

(A)  'invalid  depth  when  F=  is  specified  -  use  1  or  2') 

(5)  IFEND 


=  Srequired 
=  Srequired 
=  Srequired 
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Explanation: 

(1)  The  function  is  evaluated  (it  tests  the  value  of  DEPTH 
against  a  maximum  or  2  and  with  a  default  of  2)  and  its 
value  is  stored  in  THE_DEPTH  (this  could  have  been  some 
other  name) . 

(2-5)  If  the  function  returned  0  (error),  terminate  the  FILES 

procedure  with  an  error  condition  (false),  and  displaying 
a  message. 
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*****  Source  Libraries  ***** 

Source  programs,  data  and  other  text  may  be  in  separate  files  or 
may  be  stored  and  maintained  in  source  libraries.  SOURCE_CODE_UTILITY 
(SCU)  creates  and  maintains  these  libraries.  Additional  information 
may  be  found  in  CDC  publication  60464313,  "Source  Code  Management". 

***  SCU  Subcommands  *** 

The  following  are  subcommands  of  the  SOURCE_CODE_UTILTIY  used  to 
create,  maintain,  and  extract  decks  from  a  source  library: 

ADD_LIBRARY  Add  decks  from  source  libraries  to  the  working  library. 

CHANGE_DECK  Change  the  contents  of  deck  header  fields. 

CHANGE_DECK_NAMES 

Rename  decks. 

CHANGE_DECK_REFERENCES 

Change  the  deck  names  of  COPY/COPYC  directives  in  decks. 
CHANGEL I BR AR  Y 

Change  the  contents  of  working  library  header  fields. 
CHANGE_MODI F I CAT I ON 

Change  information  in  modification  descriptions. 
COMBINE_LIBRARY 

Add/replace  working  library  decks  from  source  libraries. 
CREATE_DECK  Create  decks. 

CREATE_LIBRARY 

Create  an  empty  source  library. 

CREATE_MOD I F I CATION 

Create  modifications  in  the  library  modification  list. 
DELETE_DECK  Delete  decks  from  the  working  library. 

DELETE_FEATURE 

Delete  features  from  a  source  library. 

DELETE_GROUP  Delete  groups  from  a  source  library. 

DELETE_MODIFICATION 

Undo  all  changes  introduced  by  specified  modif ications . 
DISPLAY_DECK  Display  deck  headers. 

DISPLAY_DECK_LIST 

List  decks  in  working  library  alphabetically  by  deck  name. 
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DISPLAY_DECK_REFERENCES 

Display  a  cross-reference  listing  for  decks  (COPY/COPYC 
directives  naming  the  decks). 

DISPLAY_FEATURES 

Display  a  feature's  modifications. 

DISPLAY_FEATURE_LIST 

List  the  features  in  a  source  library. 

DISPLAY_GROUP 

List  decks  belonging  to  a  group. 

DISPLAY_GROUP_LIST 

List  the  groups  in  a  library. 

DISPLAY_LIBRARY 

Display  the  working  library  header. 

DISPLAY_MODIFICATION 

Display  modification  headers. 

DISPLAY_MODIFICATION_LIST 

List  all  working  library  modifications. 

EDIT_DECK  Edit  a  deck. 

ENDLIBRARY  (Optionally)  write  the  current  working  library  to  a  file 
and  end  the  current  working  library. 

EXPANDDECK  Expand  decks. 

EXPAND_FILE  Expand  a  text  file. 

EXTRACT_DECK  Extract  decks  from  a  source  library. 

EXTRACT_MODIFICATION 

Generate  a  file  of  EDIT_FILE  subcommands  to  make  the 
modification  changes. 

QUIT  End  SCU  and  optionally  write  the  working  library  to  a  file. 

REPLACE_LIBRARY 

Replace  working  library  decks  with  source  library  decks. 

SEQUENCE_DECK 

Sequence  deck  lines  in  released  state. 

SEQUENCE_MODIFICATION 

Sequence  modification  lines. 

SET_LIST_OPTIONS 

Establish  default  LIST  parameters  for  SCU  subcommands. 
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USE_LIBRARY  Start  a  new  working  library  with  the  decks  from  a  source 
library. 

WRITE_LIBRARY 

Write  the  working  library  into  a  file. 


***  NOS/VE  Source  Library  Commands  *** 

The  following  NOS/VE  commands  are  used  with  source  libraries: 
CONVERT_UPDATE_TO_SCU 

Convert  a  source  library  from  NOS  UPDATE  format  to  SCU 
format . 

EXPAND_SOURCE_FILE 

Expand  a  text  file  as  though  it  were  a  deck  in  an  SCU 
1 ibrary. 

EXTRACT_SOURCE_L I BR AR  Y 

Extract  decks  from  a  library  for  use  as  a  separate 
library. 

GENERATE_SCU_EDIT_COMMANDS 

Compare  a  deck  to  a  text  file  and  produce  a  file  of  edit 
commands  to  convert  the  deck  to  the  text  file. 


***  Embedded  SCU  Directives  *** 

The  following  SCU  directives  are  embedded  with  decks: 


•'BLOCK 

*BLOCKEND 

*COPY 

*C0PYC 

*DECK 

*IF 

*ELSEIF 
*ELSE 
* I FEND 

’•TEXT 

*TEXTEND 


*WEOP 

*WE0PC 


Delimit  a  block  of  text. 

Copy  a  deck  into  the  expanded  text  file. 

Conditionally  copy  a  deck  into  the  expanded  text  file. 
Starts  a  new  deck. 


Conditional  expansion. 

Delimit  a  block  of  text  whose  embedded  directives  are  not 
to  be  processed. 

Write  end-of-part i t i on  on  the  expanded  text  file. 

Conditionally  write  end-of-part i t i on  on  the  expanded  text 
file. 
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***  Other  Subcommands  *** 

In  addition,  ..here  are  many  subcommands  and  functions  for  the 
selection  criteria  of  an  EXPAND_DECK,  EXTRACT_DECK,  and  EXTRACT_SOURCE_ 
LIBRARY;  and  many  functions  for  obtaining  information  about  the  library. 
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*****  Object  Libraries  ***** 

CREATE_OB JECT_LIBRARY  (creol)  is  a  utility  for  creating  and 
maintaining  object  libraries  of  load  modules,  function  modules,  SCL 
procedure  modules,  and  message  modules.  CREOL  uses  a  module  list 
while  processing  its  subcommands.  Your  library  is  not  modified  until 
you  generate  a  new  library. 

This  section  discusses  object  libraries.  See  section  9-4  for  SCL 
procedure  and  functions  libraries;  and  9~3  for  message/help  libraries. 

***  Subcommands  *** 

ADDMODULE 

Add  one  or  more  modules  to  the  module  list. 

Syntax:  ADDMODULE  -or- 

ADD_MODULES  ~or- 
ADDM 

L  or  LIBRARY  or  LIBRARIES=f ile 


M  or  MODULE  or  MODULES=list  of  program_name  or 
list  of  range  of  program_name 
P  or  P LACEMENT*k eywo r d 
D  or  DESTINATION=program_name 
STATUS=status  variable 

Parameters:  L  -  object  files,  SCL  procedure  files,  or  object 
libraries  containing  the  modules  to  be  added 

M  -  modules  to  be  added 

(default:  all  modules) 

P  -  whether  the  modules  are  to  be  added  before  or 
after  the  DESTINATION  module 


ab 

opt i on 

meaning 

B 

BEFORE 

add  modules 

before  the 

destination 

module 

A 

AFTER 

add  modules 

after  the 

destination 

module 

(default:  AFTER) 


D  -  module  before  or  after  which  the  modules  are 
to  be  added 

(default:  P=B:  before  the  first  module; 

P=A:  after  the  last  module) 
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Remarks : 


If  an  SCL  procedure  has  a  header  parameter  of  a 
non-standard  type,  the  type  definition  must  be 
created  outside  the  procedure. 


See  also:  COMBINE_MODULES;  REPLACE_MODULES 

Examples:  COL/addm  (binl,bin2)  P=before 

A —  adds  all  modules  in  BIN1  and 
BIN2  at  the  start  of  the 
module  list 


CHANGE_COMMAND_DESCR I PT ION 

Change  the  command  description  of  a  command  processor. 


CHANGE_FUNCTION_DESCRIPTION 

Change  the  command  description  parameters  of  a  function 
processor . 


CHANGE_MODULE_ATTR IBUTE 

Change  attributes  of  a  module  in  the  module  list. 


Syntax: 


CHANGE_MODULE_ATTRIBUTE  -or- 
CHANGE_MODULE_ATTRIBUTES  -or- 
CHAMA 

M  or  MODULE  or  MODULES=keyword  or 
list  of  programname  or 
list  of  range  of  programname 


NN 

or 

S 

or 

0 

or 

G 

or 

NG 

or 

SP 

or 

OL 

or 

AL 

or 

R 

or 

NR 

or 

ONREP 

or 

ODT 

or 

C 

or 

AI 

or 

CPC 

or 

NEW_NAME=program_name 
SUBSTITUTE  or  SUBSTITUTES'^ is t  of 

record 

OMIT=list  of  program_name 
GATE=keyword  or  list  of  program  name 
NOT_GATE=keyword  or 
list  of  program_name 
STARTING_PROCEDURE=program_name 
OMIT_LIBRARY  or  OMIT_LIBRARIES= 
list  of  name 

ADD  LIBRARY  or  ADD  LIBRARY=1 ist  of 


name 

RETAIN=keyword  or  list  of  program_name 
NOT_RETAIN=keyword  or 
list  of  program_name 
OMIT_NON_RETAINED_ENTRY_POINTS=boolean 
OMIT_DEBUG_TABLES  or  OMIT_DEBUG_ 
TABLES=keyword  or  list  of  keyword 
COMMENT=s  tring 


APPLICATION_IDENTIFIER=keyword  or 
name 


CYBIL_PARAMETER_CHECKING=keyword 
STATUS=status  variable 
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Parameters: 


M  -  the  modules  whose  attributes  are  to  be 
changed  -or- 
ALL  -  all  modules 


(defaults  for  rest  of  parameters:  no  change) 


NN  -  new  module  name 

(do  not  use  if  M=list  of  modules  or 
M=ALL) 


(attribute  for  rest  of  parameters:  BY_NAME) 


S 


0 

G 


NG 


SP 

OL 


AL 


R 


NR 


-  a  list  of  name  substitutions  —  each 
record  in  the  list  specifies  two  names: 
the  existing  name  and  the  new  name 

-  list  of  names  whose  definitions  are  to  be 
removed  from  the  module 

-  list  of  entry  points  to  which  the  gate 
attribute  is  to  be  added  -or- 

ALL  -  all  modules 

-  list  of  entry  points  to  which  the  gate 
attribute  is  to  be  removed  -or- 

ALL  -  all  modules 

-  name  of  the  entry  point  where  execution 
is  to  begin 

-  the  local  file  names  to  be  removed  from 

the  object  text  (these  are  object 
libraries  to  be  added  to  the  program 
library  Iis>  the  module  is  loaded) 

-  the  local  file  names  to  be  added  to  the 
object  text  (these  are  object  libraries 
to  be  added  to  the  program  library  list 
when  the  module  is  loaded) 

-  list  of  additional  entry  points  to  be 
given  the  retain  attribute,  that  is,  are 
to  be  kept  in  a  new  module  created  by 
combining  with  other  modules  -or- 

ALL  -  all  modules 

-  list  of  additional  entry  points  to  lose 
the  retain  attribute,  that  is,  are  net 
to  be  kept  in  a  new  module  created  by 
combining  with  other  modules  -or- 

ALL  -  all  modules 


ONREP  -  all  entry  points  are  to  be  removed  from 
the  module  unless  specifically  retained 
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ODT  -  the  debug  tables  to  be  omitted  when 
loading 


ab 

option  meaning 

LT 

LINE_TABLE 

omit  line  number 

table 

ST 

SYMBOL_TABLE 

omit  table  of  names 

and  addresses  of 

variables 

SDT 

SUPPLEMENTAL 

omit  table  of  screen 

DEBUG  TABLE 

mode  information 

PC 

PARAMETER_ 

omit  parameter 

CHECKING  checking  records 

ALL  omit  all  debug 

tables 

C  -  1-40  characters  to  be  stored  in  the 
module  header 

AI  -  the  name  of  the  application  associated 
with  the  module  ~or~ 

$UNSPECIFIED  -  remove  the  application 
identifier 

(need  APPLICATION_ADMINISTRATION 
permission) 

CPC  -  only  for  CYBIL  programs 

Remarks:  These  changes  change  the  attributes  when  a  new 

library  is  generated. 


Examples : 


CHANGE_PROGRAM_DESCR I PT ION 

Change  the  components  of  a  program  description. 


Syntax : 


CHANGE_PROGRAM_DESCRIPTION  ~or~ 

CHAPD 

N  or  NAME  or  NAMES=list  of  name 


F  or  FILES  or  FILE=keyword  or 
list  of:  file  or  string 
L  or  LIBRARIES  or  LIBRARY=keyword  or 

list  of:  keyword  or  file  or  string 
M  or  MODULES  or  M0DULE=keyword  or 
list  of  program_name 
SP  or  STARTING_PROCEDURE=keyword  or 
program_name 

LM  or  LOAD_MAP=keyword  or  file  or  string 

LMO  or  L0AD_MAP_0PTI0NS  or 

LOAD_MAP_OPT I ON= keyword  or 

list  of  keyword 
TEL  or  TERMINATION_ERROR_LEVEL=keyword 
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PV  or  PRESET_VALUE=keyword 

SS  or  STACK_SIZE=keyword  or  integer 

AF  or  ABORT_FILE=keyword  or  file  or  string 
DI  or  DEBUG_INPUT=keyword  or  file  or  string 
DO  or  DEBUG_OUTPUT=keyword  or  file  or  string 
DM  or  DEBUG_MODE=keyword  or  boolean 

A  or  AVAILABILITY=keyword 

S  or  SCOPE=keyword 

LO  or  LOG_OPTION=keyword 

AI  or  APPLICATION_IDENTIFIER=keyword  or 

name 

AO  or  ARITHMETIC_OVERFLOW=keyword  or  boolean 
ALOS  or  ARITHMETIC_LOSS_OF_SIGNIFICANCE= 
keyword  or  boolean 

DF  or  DIVIDE_FAULT=keyword  or  boolean 

EO  or  EXPONENT_OVERFLOW=keyword  or  boolean 

EU  or  EXPONENT_UNDERFLOW=keyword  or  boolean 

FI  or  FPI  or  FP_INDEFINITE=keyword  or 

boolean 

FLOS  or  FP_LOSS_OF_SIGNIFICANCE=keyword  or 
boolean 

IBD  or  IBDPD  or  I NVAL I D_BDP_DATA=k eywo r d  or 
boolean 

STATUS=status  variable 

Parameters:  N  -  the  names  of  the  program  descriptions  to 

be  changed 


Remarks : 
Examples : 


COMB INE_MODULE 

Add  or  replace  modules  in  the  module  list. 

Syntax:  COMBINE_MODULE  -or- 

COMB INE_MODULES  -or- 
COMM 

L  or  LIBRARY  or  LIBRARIES=f ile 


M  or  MODULE  or  MODULES=list  of  program_name  or 
list  of  range  r. r  program_name 
P  or  PLACEMENT=keyword 
D  or  DESTINATION^progranwrame 
STATUS=status  variable 

Parameters:  L  -  object  files,  SCL  procedure  files,  or  object 
libraries  containing  the  modules  to  be  added 

M  -  modules  to  be  added  or  replaced 
(default:  all  modules) 
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P  -  whether  the  added  modules  are  to  be  placed 
before  or  after  the  DESTINATION  module 

ab  option  meaning 


B  BEFORE  added  modules  go  before  the 
destination  module 

A  AFTER  added  modules  go  after  the 
destination  module 

(default:  AFTER) 

D  -  module  before  or  after  which  the  added 
modules  are  to  be  placed 
(default:  P=B:  before  the  first  module; 

P=A:  after  the  last  module) 

Remarks:  If  an  SCL  procedure  has  a  header  parameter  of  a 

non-standard  type,  the  type  definition  must  be 
created  outside  the  procedure. 

See  also:  ADD_MODULES;  REPLACE_MODULES 

Examples:  COL/comm  (binl,bin2)  P=before 

A —  adds  or  replaces  all  modules  in 
BIN1  and  BIN2  at  the  start  of 
the  module  list 


CREATE_COMMAND_DESCRIPTION 

For  use  with  CYBIL  programs. 


CREATE_FORM_MODULE 

Start  the  CREATE_FORM_MODULE  utility  to  create  a  form. 

Syntax:  CREATE_FORM_MODULE  -or- 

CREFM 

FN  or  FORM  NAME=name 


MO  or  MERGE_0PTI0N=keyword 

STATUS=status  variable 

Parameters:  FN  -  the  name  of  the  form 

MO  -  merge  option 

ab  option  meaning 

A  ADD  add  the  module  to  the  library 

R  REPLACE  replace  the  module 
C  COMBINE  add  or  replace  the  module 
(default:  COMBINE) 
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Subcommand  prompt:  CFM/ 

Examples : 

CREATE_FUNCT I ON_DESCR I PT I ON 

For  use  with  CYBIL  programs. 

CREATE_LINKED_MODULE 

Create  a  prelinked  module  from  an  existing  module  and  add  it 
to  the  module  list. 

Syntax:  CREATE_L INKED_MODULE  -or- 

CRELM 

N  or  NAME=program_name 

C  or  COMPONENT  or  COMPONENTS=list  of  record 


RB  or  RING_BRACKETS= record 
RCB  or  RETAIN_COMMON_BLOCK=keyword  or 
list  of  programname 
ISN  or  IGNORE_SECTION_NAMES=boolean 
SS  or  STARTING_SEGMENT= integer 
0  or  OUTPUT=f i le 
BT  or  DEBUG_TABLE=f i 1 e 

NAS  or  NEXT_AVAILABLE_SEGMENT= integer  variable 
AI  or  APPLICATION_IDENTIFIER=name 
DEP  or  DEFER_ENTRY_POINT=keyword  or  record  or 
list  of  program_name 

DCB  or  DEFER_COMMON_BLOCKS=keyword  or  record  or 
list  of  program_name 
STATUS=status  variable 

Parameters : 

Remarks : 

Examples : 


CREATE_MODULE 

Create  a  new  load  module  form  existing  modules  and  add  it  to 
the  module  list. 

Syntax:  CREATE_MODULE  ~or_ 

CREM 

N  or  NAME=program_name 

C  or  COMPONENT  or  COMPONENTS'! is t  of  record 


G  or  GATE  or  GATES'keyword  or  list  of 

program_name 

R  or  RETAIN'keyword  or  list  of  program_name 

SP  or  STARTING_PROCEDURE=pi ogram_name 

PV  or  PRESET_VALUE=keyword 
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IBMS  or  INCLUDE_BINARY_SECTION_MAPS=boolean 
0  or  OUTPUT=f i le 
AI  or  APPLICATION_IDENTIFIER=name 
STATUS=s tatus  variable 

Parameters : 

Remarks : 

Examples : 


CR  EATE_PROGR AM_DESCR I P  T I ON 

Create  a  program  description  and  add  it  to  the  module  list. 

Syntax:  CREATE_PROGRAM_DESCRIPTION  -or- 

CREPD 

N  or  NAME  or  NAMES'record 

F  or  FILES  or  FILE=list  of:  file  or  string 
L  or  LIBRARIES  or  LIBRARY=list  of:  keyword 
or  file  or  string 

M  or  MODULES  or  MODULE=list  of  program_name 

SP  or  STARTING_PROCEDURE=program_name 

LM  or  LOAD_MAP=f i le  or  string 

LMO  or  L0AD_MAP_0PTI0NS  or 

LOAD_MAP~OPTION=keyword  or 

list  of  keyword 
TEL  or  TERMINATION_ERROR_LEVEL=keyword 
PV  or  PRESET_VALUE=keyword 

SS  or  STACK_SIZE=integer 

AF  or  AB0RT_FILE=f ile  or  string 

DI  or  DEBUG_ INPUT=  file  or  string 

DO  or  DEBUG_OUTPUT=  file  or  string 

DM  or  DEBUG_MODE=boolean 

A  or  AVAILABILITY=keyword 

S  or  SC0PE=keyword 

L0  or  LOG_OPTION=keyword 

MO  or  MERGE_OPTION=keyword 

AI  or  APPLICATION_IDENTIFIER=name 

AO  or  ARITHMETIC_OVERFLOW=boolean 

ALOS  or  AR I THMET I C_LOS S_0F_S I GN I F I CANCE= 
ooolean 

DF  or  DIVIDE_FAULT=boolean 

EO  or  EXPONENT_OVERFLOW=boolean 

EU  or  EXPONENT~UNDERFLOW=boolean 

FI  or  FPI  or  FP_INDEFINITE=boolean 
FLOS  or  FP_LOSS_OF_SIGNIFICANCE=boolean 
IBD  or  IBDPD  or  INVALID_BDP_DATA=bool ean 
STATUS'S tatus  variable 
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DELETE_MODUL£ 

Delete  one  or  more  modules  from  a  module  list. 

Syntax:  DELETE_MODULE  -or- 

DELM 

M  or  MODULE  or  MODULES=keyword  or  list  of 
program_name  or  list  of  range  of 
program_natne 

STATUS=s tatus  variable 

Parameters:  M  -  the  module  or  modules  to  be  deleted  -or- 
ALL  -  all  modules 

Examples :  / create_ob j  ect_library 

COL/addm  old_library 
COL/delm  (s4,m5) 

COL/genl  new_liDrary 
COL/quit 
/ 


DI SP  LAY_NEW_L I BRAR Y 

Display  the  contents  of  the  module  list. 

Syntax:  DISPLAY_NEW_LIBRARY  ~or~ 

DISNL 


M  or  MODULE  or  MODULES=list  of  programname 
or  list  of  range  of  program_name 
DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=keyword  or  list  of 
keyword 

0  or  OUTPUT=f ile 
AO  or  ALPHABETICAL_ORDER=boolean 
STATUS=status  variable 

Parameters:  M  -  the  modules  whose  information  is  to  be 
displayed 

DO  -  display  options 

ab  option  meaning 


NONE  type  and  name  only 

DT  DATE_TIME  creation  date/time 

EP  ENTRY_POINT  entry  point  names 

H  HEADER  module  header  information 

L  LIBRARY  local  file  names  in  the 

LIBRARIES  object  text 
R  REFERENCE  external  references 

C  COMPONENT  module  headers  of 

component  modules  of  a 
bound  module 

ALL  all  options 

(default:  DATE_TIME  or  the  value  set  by 
last  SET  DISPLAY  OPTIONS) 
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AO  -  TRUE  -  alphabetical  listing 

FALSE  -  listing  is  in  library  or  file  order 
(default:  FALSE) 

Remarks : 

DISNL  displays  the  modules  as  they  sould  appear 
in  a  library  created  by  GENERATE_LIBRARY . 

Examples : 

/creol 

COL/addm  mylib 

COL/disnl 

<list  of  contents> 

COL/more  CREOL  subcommands 

COL/genl  mylib. $next 

COL/qui t 
/ 

GENERaTE_LIBRARY 

Generate  a  new  object  library  containing  the  modules  in  the 
module  list.  It  can  also  write  an  object  file,  SCL  procedure 
text  file,  form  source  file,  form  variable  file,  or  CREATE 

MESSAGE_MODULE  subcommands . 

Syntax: 

GENERATE  LIBRARY  -or~ 

GENL 

L  or  LIBRARY=f ile 

F  or  FORMAT=keyword 

STATUS=status  variable 

Parameters : 

L  -  the  file  to  hold  the  new  library 

F  -  the  output  format: 

ab  option 

L  LIBRARY 

F  FILE 

FS  FORM  SOURCE 

FV  FORM  VARIABLE 

SP,  SP  PR OC  SCL  PROCEDURE 

MM  MESSAGE  MODULE 

(default:  LIBRARY) 

Remarks : 

Requires  APPEND  and  SHORTEN  access. 

If  the  library  is  already  in  your  (or  someone 
else's)  command  list,  it  cannot  be  overwritten. 

You  should  create  a  new  cycle.  An  attempt  to 
overwrite  such  a  file  will  cause  a  unique  file 
to  be  created  in  SLOCAL. 

See  also: 

CREATE_OBJECT_LIBRARY 
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QUIT  End  a  CREATE_OB JECT_LIBRARY  utility  session. 

Syntax:  QUIT  -or- 

QUI 

REORDER_MODULE 

Reorder  modules  in  the  module  list. 

Syntax:  REORDER_MODULE  -or- 

REORDER_MODULES  -or- 
REOM 

M  or  MODULE  or  MODULES=list  of  program_name  or 
list  of  range  of  program_name 


P  or  PLACEMENT=keyword 
D  or  DESTINATION=pr ogram_name 
STATUS=s tatus  variable 

Parameters:  M  -  list  of  modules  in  the  order  you  want  them 

P  -  whether  the  modules  are  to  be  added  before  or 
after  the  DESTINATION  module 

ab  option  meaning 

B  BEFORE  add  modules  before  the 
destination  module 
A  AFTER  add  modules  after  the 
destination  module 

(default:  AFTER) 

D  -  module  before  or  after  which  the  modules  are 
to  be  added 

(default:  P=B;  before  the  first  module; 

P=A:  after  the  last  module) 

Remarks : 

Examples:  module  list:  A,  B,  C,  D,  E 

REOM  (c.bl 

module  list:  A,  D,  E,  C,  B 
REOM  d  B 

module  list:  D,  A,  E,  C,  B 
REOM  e  A  c 

module  list:  A,  D,  C,  E,  B 
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REPLACEMCDU1E 

Replace  modules  in  the  module  list. 

Syntax:  REPLACE_MODULE  -or- 

R  E  P  LAC  E_MODU  L  E  S  ~or- 
REPM 

L  or  LIBRARY  or  LIBRARIES=f ile 


M  or  MODULE  or  MODULES=list  of  program_name  or 
list  of  range  of  program_name 
STATUS=status  variable 

Parameters:  L  -  object  files,  SCL  procedure  files,  or  object 

libraries  containing  the  modules  to  be  added 

M  -  modules  to  be  added 

(default:  all  modules) 

Remarks:  If  an  SCL  procedure  has  a  header  parameter  of  a 

non-standard  type,  the  type  definition  must  be 
created  outside  the  procedure. 

See  also:  ADD_MODULES;  COMBINE_MODULES 

Examples:  COL/repm  (binl,bin2) 

A —  replaces  all  modules  in  BINl  and 
BIN2 


SAT I SF Y_EXTERNAL_REFERENCE 

Add  modules  to  the  module  list  which  satisfy  external 
references . 

Syntax:  SATISFY_EXTERNAL_REFERENCE  -or- 

SATISFY_EXTERNAL_REFERENCES  or 
SATER 

L  or  LIBRARY=list  of  file 

STATUS=s tatus  variable 

Parameters:  L  -  object  library  files  in  the  order  they  are  to 

be  searched 

Remarks : 


Examples : 


90/09/30 


RevO 


Page  8-7-13 


SET_DISPLAY_OPTION 

Change/display  default  settings  for  subsequent  DISPLAY_NEW 
LIBRARY  subcommand  of  CREOL. 

Syntax:  SET_DISPLAY_OPTION  -or- 

SET_DISPLAY_OPTIONS  or 
SETDO 


DO  or  DISPLAY_OPTION  or 

DISPLAY_OPT I 0NS= keyword  or 
list  of  keyword 
STATUS=status  variable 

Parameters:  DO  -  display  options 


ab 

option 

meaning 

NONE 

type  and  name  only 

DT 

DATE  TIME 

creation  date/time 

EP 

ENTRY  POINT 

entry  point  names 

H 

HEADER 

module  header  information 

L 

LIBRARIES 

local  file  names  in  the 
object  text 

R 

REFERENCE 

external  references 

C 

COMPONENT 

module  headers  of 
comp  nent  modules  of  a 
bound  module 

ALL 

all  options 

(initial  default:  DATE  TIME) 


Remarks : 


Examples : 
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***  DTRC  Object  Libraries  *** 

The  following  object  libraries  have  been  added  to  NOS/VE  at  DTRC: 

.NSYS.DTLIB  -  Subprograms  written  or  maintained  by  the 
Computer  Center 

To  use:  /execute^task  f ile=$user .main_lgo  .. 
. ./library'. NSYS.DTLIB 

. NSYS . UTILITY  -  Programs  written  or  maintained  by  the 
Computer  Center 

To  use:  .nsys . ut i 1 i ty . <program> 


Examples 

1)  Create  a  library  of  subprograms  (all  files  are  assumed  to  be  in  your 
working  catalog) . 


/ftn  mysubss 
/ createobj  ectl ibrary 
COL/add_modules  Slocal.lgo 
COL/display_new_l ibrary 

COL/generate_l ibrary  mylib 

COL/quit 

/ 


2)  Add  a  subprogram  to  an  existing 

/fortran  n-»wsub 
/creol 

COL/addm  mylib 
COL/addm  Slocal.lgo 
COL/disnl 
COL/genl  mylib 
COL/ quit 
/ 


< —  compile  subprograms 
< —  invoke  CREOL  utility 
< —  addm 

< —  disnl  —  look  at  what  new 
library  will  contain 
< —  genl  —  create  the  new  library 
MYLIB 

< —  leave  CREOL 


ibrary. 


< —  or  "addm  (myl ib , Slocal . lgo) " 

< —  optional 
< —  replace  old  library 


3)  Replace  a  subprogram  in  an  existing  library  of  subprograms. 

/for  oldsub 
/creol 

COL/addm  mylib 
COL/repm  Slocal.lgo 

COL/genl  mylib. Snext  < —  make  new  cycle  of  library 

COL/ quit 
/disol  mylib 
/ 


< —  display  contents  of  mylib 
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A)  Delete  subprograms  BADSUBl  and  BADSUB2  from  an  existing  library, 
/creol 

COL/addm  mylib 

COL/delete_modules  (badsubl ,badsub2) 

COL/genl  mylib 
COL/quit 
/ 
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***** 


Program/Command/Procedure  Execution 


Programs,  commands  and  procedures  are  executed  in  one  of  the 
following  ways: 

.  name  reference  (if  it  is  in  your  command  list) 

.  filename  reference  (if  it  is  in  a  catalog  in  your  command  list) 

.  full-path  file  reference  (any  file  for  which  you  have  read  or 
execute  permission) 

.  utility  name  and  subcommand  name  (if  you  are  in  a  utility  with 
one  or  more  active  subutilities  and  a  subcommand  name  is  the  same 
in  the  utility  and/or  its  subutilities) 

.  EXECUTE_COMMAND  (to  execute  a  single  NOS/VE  command  as  an 
asynchronous  task) 

.  EXECUTE_TASK  (to  execute  a  single  program  as  either  a  synchronous 
or  an  asynchronous  task  —  use  when  multiple  load  modules, 
subprogram  libraries,  fault  switches,  memory  preset,  load  maps, 
debugging  mode,  etc.,  are  needed) 

See  Appendix  H  for  descriptions  of  many  of  the  commands  mentioned  in 
this  section. 


***  Command  Lists  *** 

A  command  list  is  the  set  of  commands  and  functions  (section  8-4) 
available  to  you.  Commands  may  reside  in  object  libraries,  in  catalogs, 
as  command  entries  in  $SYSTEM,  or  as  utility  subcommands.  Each  entry 
is  called  a  command  list  entry.  You  can  change  your  command  list  by 
adding,  deleting,  or  replacing  entries.  You  can  also  control  the 
search  order. 

At  login,  your  command  list  includes  all  NOS/VE  system  commands  (in 
5SYSTEM) ,  the  $LOCAL  catalog,  and  several  additional  entries  with 
routines  developed  at  DTRC. 

5SYSTEM  commands  may  be  executed  specifically  by: 

5SYSTEM. command_name 

which  causes  only  the  5SYSTEM  command  list  entry  to  be  searched. 


When  you  start  a  utility,  its  command  list  entry  (containing 
subcommands  and  functions)  is  added  at  the  start  of  your  command  list. 
It  is  deleted  when  you  exit  from  the  utility. 
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Control  statements  are  used  to  structure  and  control  the  job  flow. 
The  command  list  entry  containing  them  is  always  searched  first.  It 
cannot  be  deleted  or  replaced  in  your  command  list.  It  also  contains: 

COLLECT_TEXT 
JOB  and  JOBEND 
TASK  and  TASKEND 
UTILITY  and  UTILITYEND 

which  also  are  in  SSYSTEM. 


The  following  commands,  which  are  also  in  SSYSTEM,  are  in  a  special 
command  list  entry  which  is  always  searched  last  and  which  cannot  be 
deleted  or  replaced  in  your  command  list: 


CHANGE_COMMAND_SEARCH_MODE 

CREATE_COMMAND_LIST_ENTRY 

DELETE_COMMAND_LIST_ENTRY 

DELETE_VARIABLE 

DISPLAY_COMMAND_INFORMATION 

DISPLAY_COMMAND_LIST 

DI SP  LAY_COMMAND_L I ST_ENTR Y 

DISPLAY_VALUE 

DISPLAY_VARIABLE_LIST 

GET_LINE 

INCLUDE_COMMAND 

INCLUDE_FILE 

INCLUDE_LINE 

LOGIN 

LOGOUT 

PUT  LINE 


Search  Modes 


?Wc>V 


The  command  list  can  be  searched  in  one  of  the  following  ways: 

GLOBAL  All  entries  in  the  command  list  can  be  searched;  commands 

specified  by  path  or  command  name  may  also  be  executed. 

RESTRICTED  All  entries  in  the  command  list  are  candidates  to  be 

searched  (to  search  beyond  the  first  entry,  the  command 
must  be  preceded  by  a  slash  (/) ;  commands  specified  by 
path  or  command  name  may  also  be  executed. 


EXCLUSIVE  Only  the  first  entry  of  the  command  lis*"  is  searched; 

commands  specified  by  path  or  command  name  may  not  be 
executed.  Also,  CHANGE_COMMAND_SEARCH_MODE ,  CREATE_ 
COMMAND_LIST_ENTRY,  and  DELETE_COMMAND_LIST_ENTRY  cannot 
be  executed.  SCL  assignment  and  control  statements  may 
always  be  executed. 
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***  Examples  *** 

1)  Execute  program  in  file  MYPROG  in  the  current  directory  (.ABCD): 

.abcd.myprog 

2)  Execute  program  MYPROG  in  library  MYLIB  in  the  current  directory 
(.ABCD): 

.abcd.mylib.myprog 

3)  Execute  program  MYPROG  in  library  MYLIB,  which  is  in  my  command 
list: 


myprog 
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*****  On-line  Manuals  ***** 

This  section  is  reserved  for  a  description  of  on-line  manuals, 
will  be  part  of  Revision  1. 


It 


90/09/30 


RevO 


Page  8-10-1 


*****  Other  Software  ***** 

***  Accessing  Other  Software  *** 

Programs  obtained  from  other  vendors  are  normally  execute-only.  To 
execute  them,  you  normally  need  only  specify  the  filepath: 

.un.file  < —  where  un  is  the  username  under  which  the 

program  is  stored  (normally 
NSYS) 

file  is  the  name  of  the  program  file 


**  .NSYS  ** 

DTRC-written  programs  are  in  the  NSYS  catalog.  As  of  the  date  of 
this  page,  .NSYS  contains: 


None 
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*****  CDC  CYBER  180/860  —  NOS  ***** 

The  Control  Data  Corporation  (CDC)  CYBER  180  model  860  when 
operating  under  NOS  has  a  single  central  processing  unit  (CPU)  and 
16000000  octal  (2,097,120)  60-bit  words  of  memory,  of  which  400000 
octal  is  addressable  by  each  job. 

The  CPU  has  24  registers  for  operating  on  information:  8  address 
(A),  8  operand  (X)  and  8  increment  (B)  registers.  The  CYBER  860  has  a 
buffer  of  12  central  memory  (CM)  words  of  instructions,  called  an 
instruction  stack,  and  a  2048-word,  high-speed  cache  memory. 

Peripheral  processors  (PPs)  are  small  computers  (4096  12-bit  words 
of  memory)  which  handle  most  input  and  output  (.1/0)  .  There  are  20 
normal  and  5  concurrent  PPs  on  the  CYBER  860. 

There  are  28  normal  and  5  concurrent  1/0  channels.  Most  peripheral 
equipment  interfaces  with  the  central  system  through  the  PPs  via  the 
I/O  channels.  The  printers  and  remote  terminals  interface  with  the 
system  via  CDCnet. 


***  NOS  Version  2.7.1  *** 

One  operating  system  for  the  CDC  CYBER  860  at  DTRC  is  called  the 
Network  Operating  System,  version  2.7.1  (NOS  2.7  -  level  716)  and 
differs  only  slightly  from  the  standard  NOS  system.  The  interactive 
subsystem  is  called  IAF  (interActive  Facility);  the  subsystem  for 
medium-speed  remote  batch  terminals  is  called  RBF  (Remote  Batch 
Faci 1 i ty) . 

Permanent  files  (user  programs  and  data  files  retained  for  frequent 
use)  reside  on  model  895  disk  drives  and  the  Mass  Storage  System.  User 
files,  if  not  specifically  requested  on  a  tape,  will  be  assigned  to 
available  disk  areas. 

NOS  operates  in  a  "dual-state"  with  NOS/VE  (see  Chapter  8). 
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***  Accessing  NOS  on  the  CDC  860  *** 

To  access  NOS  on  the  CDC  CYBER  860: 

.  dial  (301)  227-5200  < —  this  will  connect  you  with  DTNET 

at  1200  baud  (see  page  1—1—4  for 
higher  speeds) 

.  press  the  RETURN  key  until  it  displays  the  DTNET>  prompt 

.  enter  "CONNECT  cdc860"  (or  "C  cdc860")  to  connect  to  NOS 

.  in  response  to  the  Family:  prompt,  enter  either 
.  ,xxxx,pw,IAF  (xxxx  is  your  User  Initials, 
pw  is  your  login  password 

IAF  is  the  NOS  InterActive  Facility) 

-or- 

.  RETURN,  then  the  rest  of  the  information  one  item  at  a  time 
as  prompted 

.  in  response  to  the  CHARGE  NUMBER  (if  requested):  prompt, 
enter  your  Job  Order  Number  (see  Appendix  I:  CHVAL,CN) 

.  when  you  receive  the  "/"  prompt,  you  are  in  IAF 

.  if  you  entered  your  Job  Order  Number  incorrectly,  you  must 
enter  "CHARGE, number . "  at  the  "/"  prompt  until  a  valid 
number  is  accepted 
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Terminal  Keys  *** 

NOS  supports  screen  formatting  for  most  display  terminals.  Many 
commands  use  a  full-screen  mode  when  the  SCREEN  command  is  used.  When 
these  commands  show  function  keys,  they  are  shown  as  they  appear  on  a 
CDC  Viking  721  terminal.  When  using  other  terminals,  different  keys  or 
sequence  of  keys  may  be  needed  for  the  desired  function. 

The  following  table  shows  the  key(s)  to  be  used  for  some  terminals 
at  DTRC.  The  DT100  keypad  for  use  in  FSE  is  on  page  9-l~5. 


+  RETURN 


CDC  DEC  Tektronix 

Viking  721  VT100  T4115 


keypad  1 
+  RETURN 


keypad  2 
+  RETURN 


keypad  3 
+  RETURN 


keypad  4 
+  RETURN 


keypad  5 
+  RETURN 


keypad  6 
+  RETURN 


keypad  7 
*  RETURN 


keypad  8 
+  RETURN 


CDC  DEC 

Viking  721  VT100 


Tektronix 

T4115 


Ctrl  S 


Ctrl  D 


Ctrl  F 


shift  FI 


shift  F2 


shift  F4 


PF1 

+  RETURN 


PF2 

+  RETURN 


PF3 

+  RETURN 


PF4 

+  RETURN 


shift  F5  |  keypad  - 
|  +  RETURN 


shift  F6  |  keypad  , 

|  +  RETURN 


shift  F7  ]  kp  ENTER 
|  +  RETURN 


!  keypad  9  |  ctrl  A  j  |  shift  F9 


shift  F10 


shift  Fll 


shift  F12 


shift 

FI 

shift 

F2 

shift 

F3 

shift 

F4 

• 

shift 

F5 

shift 

F6 

shift 

F7 

shift 

F8 

Ctrl 

Q 

Ctrl 

w 

Ctrl 

E 

ctrl 

R 
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CDC  DEC  Tektronix 

Viking  721  VT100  T4115 


F13 


F14 


F15 


F16 


NEXT 


HELP 


BACK 


STOP 

Ctrl  T+NEXT 


FWD 


BKW 


UP 


DOWN 


RETURN 


Ctrl  T 
+  RETURN 


RETURN 


Ctrl  T 
-  RETURN 


CDC 

Viking  721 


DEC 

VT100 


Tektronix 

T4115 


i 

-+- 


shift  F14 


i 

-+- 


shift  F16 


shift  HELP  | 


shift  STOP 


Ctrl  T 
+  RETURN 


shift  FWD  | 


shift  BKW 


shift  CLEAR! 


ctrl  T 
+  RETURN 
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SCREEN, DT100  before  entering  FSE  puts  you  in  full-screen  mode  with 
the  following  definition  of  the  keypad. 


PFl 

-+ - 

j  PF2 

1 

-  + - 

}  PF3 

1 

-+ - 

|  PF4 

1 

del 

b 

1 

1 

1 

join 

1 

1 

del 

c 

l 

]  del  w 

7 

!8 

1 

1 9 

1  _ 

1 

1 

ins 

b 

1 

1 

split 

1 

ins 

c 

1 

|  ins  w 

4 

15 

1 

I6 

1 

1  * 

1 

mark 

c 

1 

1 

1 

-+ - 

move 

! 

del 

1 

1 

|  pos 

-+ - 

!2 


j  ENTER 


mark  1  \ 


copy 


i 

-+- 


ins  1 


forward 


i 

i 

i  back 
-+ - 


!  home 


After  pressing  one  or  more  of  the  keypad  keys,  the  RETURN  key  must  be 
used  to  perform  the  requested  functions. 


The  arrow  keys  may  be  used  to  position  the  cursor. 
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***  Direct  versus  Indirect  Files  *** 

Unlike  most  other  operating  systems,  NOS  supports  two  distinct 
types  of  permanent  file:  direct  and  indirect. 

Disk  space  is  allocated  by  PRU  (physical  record  unit)  with  one  PRU 
holding  64  words  (640  6~bit  or  320  8/12— bit  characters) . 

A  direct  file  (not  to  be  confused  with  a  "direct  access"  or  random 
file)  occupies  one  or  more  blocks  of  704  PRUs  and  is  charged  by  the 
number  of  blocks  needed  to  hold  the  file.  (A  705-PRU  file  occupies  2 
blocks.)  When  you  ATTACH  a  direct  file,  you  are  working  with  the 
actual  file.  Changes  made  by  a  program  immediately  change  the  actual 
file  and  cannot  be  "undone".  Changes  made  while  editing  alter  the 
file  with  you  QUIT  FSE.  To  "undo"  the  changes  before  QUITting,  enter 
"SET  FILE  dummy"  (SF  dummy)  and  the  changes  will  be  made  to  local  file 
"dummy" . 

An  indirect  file  occupies  up  to  696  PRUs  and  is  charged  by  the 
number  of  PRUs  needed  to  hold  the  file.  (A  1-PRU  indirect  file 
occupies  1  PRU,  while  a  1-PRU  direct  file  occupies  1  block,  or  704 
PRUs.)  When  you  GET  an  indirect  file,  you  are  working  with  a  copy  of 
the  file.  Any  changes  made  by  editing  or  by  a  program  affect  only  the 
copy  and  may  be  "undone"  any  time  prior  to  REPLACE-ing  the  file.  An 
indirect  file  is  actually  a  portion  of  a  larger  "file"  containing  other 
indirect  files.  You  cannot  work  with  the  actual  file  because  a  change 
could  lengthen  it,  thus  destroying  the  file  which  physically  follows 
it.  When  you  REPLACE  an  indirect  file,  the  new  file  is  put  wherever 
there  is  room  in  the  larger  "file".  Notice  that  the  largest  indirect 
file  fits  within  one  block. 

Direct  files  are  required  for  files  larger  than  696  PRUs  and  for 
files  which  require  that  changes  be  made  in  real  time,  perhaps  for  other 
users  of  the  file. 

Indirect  files  are  recommended  for  short  files.  They  are 
especially  useful  for  source  programs  and  data  files  which  are  under 
development,  where  you  might  want  to  try  some  changes  but  not  make  them 
permanent  until  you  decide.  The  largest  indirect  file  actually  holds  a 
lot  of  information  (445,440  6~bit,  222,720  8/12-bit  characters). 
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***  Batch  Jobs  *** 

Two  forms  of  batch  job  may  be  SUBMITted  to  the  Input  Queue.  A  job 
may  be  in  an  indirect  or  direct  file,  since  it  will  be  copied  to  the 
queue. 

1)  Traditional  form  (complete  JCL) : 

j  obname , . . . . 

USER , username .password. 

CHARGE, account . 

ATTACH , MYSOR . 

FTN5, I=MYS0R. 

LGO. 

(EOR) 

<data,  if  needed> 


2)  Reformatting  directive  form  (assumes  batch  password  and  account 
number  are  the  same  as  the  interactive) : 

/JOB 

j  obname , . . . . 

/USER 
/CHARGE 
ATTACH, MYSOR. 

FTN5, I=MYS0R. 

LGO. 

/EOR 

<data,  if  needed5. 

Either  form  may  be  sent  to  the  input  queue  by 
SUBMIT, jclfile, TO. 

to  have  the  output  in  the  Wait  Queue. 

If  the  traditional  form  is  in  an  indirect  local  file,  it  may 
alternatively  be  sent  to  the  input  queue  by 

ROUTE, jclfile, DC=TO. 

The  reformatting-directives  form  is  preferred  since  such  JCL  files 
do  not  need  modification  each  time  the  user  password  is  changed.  More 
importantly,  it  keeps  your  account  number  and  password  away  from  prying 
eyes.  Note  that  end_of-record  is  not  in  the  same  form  for  these 
'SUBMIT'  files. 
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**  Killing  Batch  Jobs  ** 

CDC  NOS  jobs  are  identified  by  their  Job  Sequence  Numbers  (jsn). 

To  find  the  jsn,  use 

ENQUIRE, JSN. 

To  kill  a  batch  job,  use 

$  DROP, jsn.  < —  drops  job  <jsn>  from  all  queues 


**  Batch  Job  Classes  ** 

Batch  jobs  in  NOS  fall  into  three  service  classes  or  priorities: 

P2  (normal),  P3  (10) ,  and  P4  (II).  Charges  for  P3  are  higher  than  for 
P2,  and  charges  for  P4  are  higher  than  for  P3.  To  specify  a  job  class, 
use  P2,  P3,  or  P4  on  the  JOB  statement.  P2  is  the  default.  SECURE 
processing  is  not  available  on  the  CYBER  860. 

The  following  chart  shows,  for  each  job  class,  the  maximum  number  of 
such  jobs  to  be  allowed  to  execute  at  the  same  time.  They  are  listed 
in  order  of  relative  priority,  lowest  priority  first. 


Priority 

Level 

Service  Class 

Priority 

Number 
of  Jobs 

P2  Jobs 

Normal  Batch  (Default) 

21 

3 

P3  Jobs 

10  Service  Class 

24 

7 

P4  Jobs 

11  Service  Class 

27 

20 

Interactive 

30 

100 

For  the  current  rates: 

On  NOS:  BEGIN, 

RATES. 

On  VMS:  HELP  RATES 
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***  Accessing  Other  Networks  *** 

CDCnet  supports  Telnet  and  FTP  using  TCP/IP.  Note  that  the  Host 
Tables  cannot  be  updated  automatically,  therefore,  if  the  desired  host 
is  not  available,  call  User  Services,  (301)  227-1907. 


**  Connecting  to  Another  System  ** 

To  connect  to  another  system,  the  CDCnet  command  "CREC"  must  be 
used.  If  at  the  CDCnet  level,  the  command  is  "CREC  <hostname>". 

If  logged  in  to  CYBER  860,  the  command  is  "7.CREC  <hostname>" 
and  a  "$B"  session  will  be  started.  The  original  "$A"  (NOS)  session 
will  be  logged  out  automatically  if  you  do  not  reconnect  to  it  within 
the  default  time  out  period  (20  minutes) .  After  logout  on  the  remote 
system,  to  return  to  the  $A  session,  type  "CHAWC  $A" . 

If  you  connect  via  DTNET,  you  must  use  DTNET  to  initiate  another 
session. 


**  Transferring  Files  ** 

FTP  may  be  used  to  transfer  files  to  or  from  the  CDC  CYBER  860  and 
VAXcluster,  OASYS  VAXes,  Code  60  VAX,  or  other  systems  defined  in  the 
CYBER  TCP/IP  Host  Tables.  All  commands  have  a  unique  CDCnet  format, 
but  most  have  as  an  alias  the  familiar  FTP  commands. 

When  logged  in  to  NOS: 

.  Files  to  be  sent  must  be  local 

.  Files  received  will  be  local  and  you  must  DEFINE  or  SAVE  them 
.  Files  received  will  be  ASCII  (6/12) 

.  Files  to  be  sent  assume  ASCII  ~  if  Display  Code  files  contain 
carets  (A) ,  use  'name,CS=D'  to  enforce  a  Display  Code 
translation  (the  apostrophes  are  required) 

Use  '/.l  to  cancel  an  FTP  command.  Using  %2  to  stop  a  printout  will 
exit  FTP. 

For  OASYS  VAX,  the  username  and  password  must  be  entered  lower  case. 

An  ASCII  (6/12)  indirect  prolog  file  called  FTPPRLG  may  be  used  to 
include  commands  needed  for  each  FTP  execution. 

When  logged  in  to  other  system  (see  also  page  4-1-5) : 

.  Files  send  to  NOS  will  be  direct  unless  'name/lA'  is  used 
.  Permissions  may  be  set  on  NOS  file  by  'name/CT=PU' 

.  Files  being  received  at  other  host  may  be  indirect  or  direct 
.  Files  being  received  that  are  only  on  MSS  cartridge  will  give 
STAGE  INITIATED  message  without  transfer;  repeat  the  GET  in  a 
few  seconds 

Limited  help  is  available  using  "HELP"  or  "DISCI  command". 
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’■’c  Some  FTP  Commands  ** 

The  following  are  some  of  the  commands  available  in  FTP.  They  are 
illustrated  using  our  VAXcluster. 


ftp 

< - 

File  Transfer  Protocol 

verbose , on 

< - 

useful  to  see  information  on 
your  FTP  session  -  may  be 
turned  on  and  off  at  any  time 

open  dtvms3 

< - 

Enter  DT3 

User? 

< - 

Enter  your  VAX  user  name 

Password? 

< - 

Enter  your  current  VAX  password; 
if  rejected,  type  USER  <user* 
and  you  will  be  prompted  again 
for  your  password 

get  <VMS  filename*  <N0S  local  file* 

A —  must  be  on  one  line;  both  file 
names  are  required 


put  <N0S  local  file*  <VMS  filename* 

A —  if  <VMS  filename*  is  omitted, 

<N0S  local  file*  is  used  without 
a  filetype;  embedded  EORs  are 
removed;  only  the  first  file  is 
sent;  the  sent  file  will  have 
WORLD:READ  permission 

put  ' <N0S  local  file*,CS=D'  <VMS  filename* 

A —  same,  except 

if  <VMS  filename*  is  omitted, 
the  generated  <VMS  filename*  is 
"<N0S  local  file*$5LCS$7DD." 


Is 

< - 

dir  -or- 

list 

< - 

list  <name*, 

<outf ile* 

pwd 

< - 

cd  <name* 

< - 

cdup 

< - 

list  names  of  remote  files  one 
per  line 

list  file  names  with  date, 
permission,  size  (in  bytes)  of 
all  or  directory 

display  remote  working  directory 
change  remote  working  directory 
back  up  one  level  directory 


quit  -or-  bye 


< —  exit  from  FTP 
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*****  NOS  CCL  Commands  ***** 

The  NOS  CYBER  Control  Language  (CCL)  statements  are  grouped  by 
function  in  this  section.  See  Appendix  I  for  a  description  of  the 
syntax  for  each  command.  (DTRC)  indicates  a  command  or  program  added 
at  DTRC. 


***  Flow  Control  *** 

BEGIN  Transfer  control  to  a  procedure. 

DISPLAY  Evaluate  an  expression  and  put  the  result  into  the  job's 
dayfile  in  octal  and  decimal. 

ELSE  Terminate  skipping  (false  IF  command  with  same  label),  or 

initiate  skipping  (true  IF  command  with  same  label)  to  ENDIF 
with  same  label. 

ENDIF  Terminate  skipping  by  a  SKIP,  IF,  or  ELSE  command  with  a 
matching  label. 

ENDW  The  end  of  a  WHILE  loop. 

EXIT  Resume  processing  commands  after  a  previous  error. 

IF  Conditionally  skip  one  or  more  commands. 

name  Transfer  control  to  a  procedure. 

NOEXIT  Continue  processing  with  the  next  command  even  if  an  error  has 
occurred  (suppress  EXIT  processing). 

ONEXIT  Reverse  the  effect  of  NOEXIT. 

REVERT  Return  from  a  procedure. 

SET  Assign  a  value  to  a  control  register,  an  error  flag,  or  the 

enter-skipped-commands-in-the-da\ file  flag. 

SKIP  Unconditionally  skip  succeeding  commands,  ending  with  an  ENDIF 
with  a  matching  label. 


WHILE 


Start  of  a  command  loop. 
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BLOCK 
CHARGE 
CHVAL, CN 
COMMENT 

CSUBMIT 

CTIME 

DAY FILE 
DROP 

ENQUIRE 
ENTER 
ERRMSG 
GO 
j  ob 

JOBCOST 

LENGTH 

LIMITS 

LISTLID 

MFL 

NEWCHRG 

NORERUN 

NOTE 

OFFSW 

ONSW 


***  Job  Control  *,c* 

Entire  line  is  a  comment. 

Add  one  or  more  lines  of  10x10  block  letters  to  a  file. 

Validate  charging  information  for  the  job. 

Make  your  current  account  number  your  login  default. 

Place  a  comment  in  the  system  dayfile  and  the  dayfile  for  any 
of  your  jobs. 

Submit  a  job  to  a  Cray  mainframe. 

Put  the  accumulated  CPU  time  (in  seconds)  into  the  job's 
dayfile. 

Write  the  job's  dayfile  to  a  file. 

Drop  any  of  your  executing  or  queued  files  (except  the  job 
issuing  the  DROP  command) . 

Get  information  about  your  jobs. 

Enter  a  series  of  commands  on  one  line. 

Control  the  display  of  error  messages  in  a  procedure. 

Clear  the  pause  bit  of  one  of  your  jobs. 

Identifies  requirements  for  a  batch  job. 

(DTRC)  Display  the  job  cost,  SRUs  used,  and  CPU  time  in  the 
dayfile  and  file  OUTPUT. 

Gives  the  current  status  of  one  of  your  local  files. 

List  your  validation  limits. 

List  network  configuration  and  host  availability  information. 
Reset  maximum  field  length  for  subsequent  job  steps. 

(DTRC)  Set  the  current  charge  number  of  some  or  all  files. 
Clear  the  job  rerun  status. 

Create  a  file  with  the  command  line  containing  the  lines  for 
the  new  file. 

Clear  sense  switches. 

Set  sense  switches. 
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PASSWOR 

PAUSE 

QGET 

RERUN 

RESOURC 

RFL 

RTIME 

SETASL 

SETCORE 

SETJOB 

SETJSL 

SETPR 

SETTL 

STIME 

SUBMIT 

SWITCH 

UPROC 

USER 


Change  your  batch  and  interactive  passwords. 

Set  the  pause  bit  of  one  of  your  executing  jobs. 

Assign  a  queued  file  to  your  job. 

Allow  a  job  to  be  rerun  if  necessary. 

Specify  that  more  than  one  tape  drive  is  required. 

Set  running  field  length. 

Put  the  real-time  clock  time  into  the  dayfile. 

Set  the  SRU  limit  for  an  accounting  block. 

Preset  each  word  of  the  field  length  except  for  RA+2. 

Change  some  of  the  current  job's  attributes. 

Set  the  SRU  limit  for  each  subsequent  job  step. 

Decrease  the  CPU  priority  of  a  job. 

Set  the  CPU  time  limit  for  each  subsequent  job  step. 

Put  the  accumulated  SRU  value  for  the  job  into  the  dayfile. 

Put  a  job  into  the  input  queue. 

Set  sense  switches. 

Specify  a  user  prologue  to  be  executed  each  time  you  start  a 
j  ob . 

Identify  you  and  provide  validation  information  for  each  batch 
job. 
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ASCII 

CSET 

LINE 

NORMAL 

SCREEN 

TDU 

TRMDEF 

7.1 

7.2 

7.HELP 

ACCESS 

BASIC 

BATCH 

EXECUTE 

FORTRAN 

NULL 

7.D 

7.E 

IS 


***  Interactive  *** 

**  Terminal  Control  ** 

Set  terminal  to  ASCII. 

Change  the  terminal's  character  set  mode. 

Set  your  terminal  for  line  (or  scrolling)  mode  for  FSE  and 
HELPME. 

Reverse  the  effect  of  ASCII,  AUTO,  BRIEF,  and  CSET, ASCII 
commands . 

Set  your  terminal  for  screen  mode. 

Compile  a  terminal  definition  file  and  store  it  in  a  user 
library  which  can  later  be  accessed  by  a  SCREEN  or  LINE 
command. 

Change  terminal  characteristics. 

Interrupt  current  job  step. 

Terminate  current  job  step. 

Display  the  CDCnet  command  list. 

**  Subsystem  Selection  5’”v 
Select  the  ACCESS  subsystem. 

Select  the  BASIC  subsystem. 

Select  the  BATCH  subsystem. 

Select  the  EXECUTE  subsystem. 

Select  the  FORTRAN  subsystem. 

Select  the  NULL  subsystem. 

**  Interactive  Status  ** 

Immediately  detach  a  terminal  job  from  the  terminal. 
Immediate  detailed  job  status. 

Immediate  abbreviated  job  status. 
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APPSW 

BYE 

DIAL 

EXPLAIN 

GOODBYE 

HELLO 

HELP 

HELPBE 

HELPME 

LIST 

LOGIN 

LOGOUT 

RECOVER 

REDO 

SHOW 

WHATJSN 

X 

XMODEM 


**  Job  Processing  ** 

Switch  temporarily  to  an  alternate  NAM  application  program. 
Terminate  an  application. 

Send  a  one-line  message  to  another  user. 

Retrieve  an  on-line  version  of  a  CDC  manual. 

Terminate  an  application. 

Logs  you  out  of  IAF  and  switches  you  to  another  application, 
or  starts  another  login. 

Ask  for  help. 

On-line  help  for  the  NOS-equival ent  of  NOS/BE  commands. 

Display  a  brief  description  of  a  command,  prompt  for 
parameters,  execute  the  command. 

List  lines  of  a  local  file. 

Terminate  your  current  application  and  start  another. 
Terminate  an  application. 

Recover  a  detached  job  or  interrupted  terminal  session. 

Modify  and  re-execute  a  previously  entered  command  without 
having  to  retype  the  entire  command. 

Display  a  screen  formatting  panel  for  testing  purposes. 

Get  the  job  sequence  number  for  the  specified  user  name. 
Execute  a  batch  command. 

Transfer  a  file  between  NOS  and  a  PC  using  the  Christensen 
protocol . 
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ASSIGN 

AUX 

AUXPRNT 

BKSP 

CLEAR 

COPY 

COPYBF 

COPYBFR 

COPYBR 

COPYCF 

COPYCR 

COPYEI 

COPYSBF 

COPYSF8 

COPYX 

FCOPY 

FILE 

L072 

LOCK 

OUT 

OVWRITE 

PACK 

RENAME 


***  File  Management  *** 

Assign  a  file  to  a  device. 

(DTRC)  Turn  an  auxiliary  printer  on  or  off,  send  control  codes 
to  control  character  size  and  to  eject  a  page. 

(DTRC)  Print  a  file  on  an  auxiliary  printer. 

Backspace  a  file  (by  logical  records). 

Release  all  (or  all  but  one  or  more  specified)  auto-drop  files 
assigned  to  the  job. 

Copy  data  from  one  file  to  another. 

Copy  a  multi-file  file. 

(DTRC)  Restore  the  "randomness"  of  a  random  file  which  was 
copied  using  a  sequential  copy  such  as  COPYBF. 

Copy  a  records  from  one  file  to  another. 

Copy  a  coded  multi-file  file. 

Copy  a  records  from  one  coded  file  to  another. 

Copy  a  file  through  end~of-inf ormation. 

Copy  a  file,  shifting  the  lines  one  character  to  the  right  for 
printing  on  a  printer. 

(DTRC)  Copy  an  ASCII8  file,  shifting  the  lines  one  character 
to  the  right  for  printing  on  a  printer. 

Copy  a  file  until  a  user-specified  condition  is  met. 

Convert  a  file  from  one  character  set  to  another. 

(CRM)  Describe  the  attributes  of  a  file. 

Reformat  files. 

Prevent  writing  on  a  local  file. 

Send  deferred  output  files  to  the  print  or  punch  queue 
immediately. 

Overwrite  files  to  destroy  their  contents. 

Remove  all  EORs  and  EOFs  from  a  file. 

Change  the  name  of  a  local  file. 
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REQUEST  Assign  a  file  to  receive  checkpoint  dumps,  or  send  a  message 
to  the  operator  to  assign  to  the  described  device. 

RETURN  Release  files  (and  file  space  depending  on  file  type)  assigned 
to  a  job. 

REWIND  Position  file;  at  beginning-of-information  (BOI) . 

ROUTE  Direct  the  disposition  of  an  indirect  file  and  define  its 
characteristics. 

SCOPY  Copy  coded  file(s)  displaying  EORs  and  EOFs  in  the  receiving 
file. 

SETFS  Set  the  auto-drop/no-auto-drop  status  of  files  assigned  to 
your  job. 

SKIPEI  Position  a  file  at  end-of-inf ormat i on . 

SKIPF  Skip  forward  a  specified  number  of  files. 

SKIPFB  Skip  backward  a  specified  number  of  files. 

SKIPR  Skip  forward  a  specified  number  of  record  or  file  marks. 

TCOPY  Copy  X  (binary),  E,  B,  or  SI  files  to  disk,  I,  or  SI  (binary) 

tape. 

TDUMP  Octal  or  alphanumeric  dump  of  all  or  part  of  a  file. 

UNIROUT  (DTRC)  Shift  a  UNICOS  ASCII8  file  and  print  it. 

UNLOAD  Release  files  assigned  to  your  job  and  perhaps  thei:  file 
space . 

UNLOCK  Rescind  the  LOCK  command  and  clear  the  write  interlock  for 
specified  local  disk  files. 

VERIFY  Binary  file  comparison. 

WRITEF  Write  a  specified  number  of  file  marks  on  a  file. 

WRITER  Write  a  specified  number  of  empty  records  on  a  file. 
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APPEND 

ASSIGN 

ATTACH 

CATLIST 

CHANGE 

DEFINE 

GET 

GETASC 

GETATT 

PERMIT 

PURGALL 

PURGE 

PUTASC 

RECLAIM 

REPLACE 

SAVE 


DMB 

DMD 

DMP 


***  Permanent  File  *** 

Append  information  to  the  end  of  an  indirect  access  file 
without  retrieving  the  file. 

Assign  a  file  to  a  device. 

Assign  a  direct  access  permanent  file  to  a  job. 

List  permanent  file  information. 

Change  some  characteristics  of  a  permanent  file. 

Create  an  empty  direct  access  permanent  file. 

Get  copies  of  indirect  access  permanent  files  as  local  files. 

(DTRC)  Get  an  indirect  or  direct  8/12  ASCII  file  and  convert 
to  6/12  Display  Code. 

(DTRC)  Get  an  indirect  file  or  attach  a  direct  file. 

Explicitly  permit  another  user  to  access  one  of  your  private 
files . 

Purge  all  your  files  which  match  the  parameters. 

Purge  one  or  more  direct  or  indirect  permanent  files. 

(DTRC)  Convert  a  6/12-bit  Display  Code  file  to  8/12-bit  ASCII 
and  make  it  a  permanent  indirect  or  direct  file. 

Selectively  backup  and  reload  local  and  permanent  files. 

Purge  an  indirect  access  file  and  replace  it  with  a  copy  of  a 
local  file;  save  a  copy  of  a  local  file  as  a  new  indirect 
access  file. 

Put  a  copy  of  a  local  file  on  disk  as  an  indirect  access  file. 
***  Dump  Memory  *** 

Binary  dump  of  exchange  package  and  central  memory. 

Dump  the  exchange  package  or  central  memory  in  both  octal  and 
display  code. 

Dump  the  exchange  package  or  central  memory  in  octal. 
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ASSIGN 

BLANK 

LABEL 

LISTLB 

REQUEST 

REQUEST 

TAPDMP 

TAPEDMP 

TPAUDIT 

TPGET 

TPRLS 

VSN 


CKP 

RESTART 


"5;x  Tape  Management  *’”c 
Assign  a  file  to  a  device. 

Blank  label  a  magnetic  tape. 

Mount  a  magnetic  tape  and,  if  labelled,  check  the  label. 

List  labels  of  an  ANSI-labelled  tape. 

Assign  a  file  to  receive  checkpoint  dumps,  or  send  a  message 
to  the  operator  to  assign  to  the  described  device. 

Request  a  tape  be  mounted  (LABEL  is  preferred) . 

(DTRC)  Driver  to  execute  TAPEDMP  program. 

(DTRC)  Analyze  a  magnetic  tape. 

(DTRC)  Audit  the  magnetic  tapes  assigned  to  you. 

(DTRC)  Get  up  to  3  magnetic  tapes  for  use  on  the  CDC  CYBER  860 
or  DEC  VAXcluster. 

(DTRC)  Rel  ease  magnetic  tapes  assigned  to  you  by  TPGET. 

Associate  a  local  file  name  with  one  or  more  volume  serial 
numbers . 

***  Checkpoint/Restart  *** 

Take  a  checkpoint  dump. 

Restart  a  checkpointed  job. 
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***  Procedures 

BEGIN  Transfer  control  to  a  procedure. 

REVERT  Return  from  a  procedure. 

***  System  Utilities  *** 

FSE  Invoke  the  full  screen  editor. 

UPDATE  Create,  edit  or  copy  an  Update-formatted  program  library. 

***  Library  Maintenance 

CATALOG  List  information  about  each  record  in  a  file. 

COPYL  Selective  single  replacement  of  object  modules. 

COPYLM  Selective  multiple  replacement  of  object  modules. 

GTR  Selective  extraction  of  records  from  a  file. 

ITEMIZE  List  information  about  each  record  of  a  binary  file. 

LIBEDIT  Create  and  maintain  a  library  of  programs,  subprograms, 
procedures,  or  text. 

LIBGEN  Create  a  new  user  library  of  routines  for  use  by  the  loader. 

LIBRARY  (Loader)  Specify  a  set  of  global  libraries  to  be  searched  for 
externals  and  programs  and  the  order  in  which  they  are  to  be 
considered. 

ULIB  Create  a  user  library*,  add,  delete  or  replace  a  record. 

VFYLIB  List  differences  in  name,  type,  length,  and  checksum  for  the 
records  of  two  files. 

***  Programming  Languages 
C0B0L5  Compile  COBOL  74  program. 

FTN5  Compile  Fortran  77  program. 

X, BASIC  Compile  a  BASIC  program  without  changing  to  the  BASIC 
subsystem. 
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EXECUTE 

LDSET 

LGO 

LIBLOAD 

LIBRARY 

LOAD 

MAP 

name 

NOGO 

REDUCE 

RFL 

SATISFY 

SLOAD 


Loader  and  Loader-related  Control  Statements  *** 

Complete  loading,  fill  unsatisfied  references  by  system  (and 
user)  library  search,  generate  load  map  and  execute  the 
program. 

Set  any  of  several  loader  options  for  the  current  load  only. 

Load  and  execute  the  default  compiler  binary  output  file. 

Load  modules  from  specified  library  which  contains  the 
specified  entry  points. 

Specify  a  set  of  global  libraries  to  be  searched  for  externals 
and  programs  and  the  order  in  which  the  libraries  are  to  be 
searched. 

A  list  of  files  whose  contents  are  to  be  loaded. 

Specify  the  global  default  option  for  load  maps. 

Load  and  execute  binary  program  or  procedure  in  local  file 
<name> . 

Complete  the  loading  of  a  program,  including  generating  load 
map,  but  do  not  execute. 

Turn  the  reduce  flag  on  or  off. 

Set  running  field  length. 

Satisfy  unsatisfied  externals  prior  to  normal  satisfaction  at 
load  completion. 

Selectively  load  modules  from  local  file  <lfn>. 

***  Comb i na  t i on  *** 


FLR 


(DTRC)  Compile  FTN5 ,  load  with  up  to  2  libraries,  and  run. 
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DATE 

FICHE 

GRIPE 

NEWRTNS 

NEWS 

OFLREQ 

OLDNEWS 
RATES 
WHO AM I 
XEROX 


jo'r*  Miscellaneous 
(DTRC)  Put  the  date  and  timne  into  the  dayfile. 

(DTRC)  Route  a  local  file  to  microfiche. 

(DTRC)  On-line  gripe/suggestion  facility. 

(DTRC)  Display  a  brief  description  of  new  routines  added  at 
DTRC . 

(DTRC)  Display  the  current  news  items. 

(DTRC)  Generate  an  Off-Line  Request  to  process  tapes  for  the 
Calcomp,  Xerox  or  Microfiche. 

(DTRC)  Display  the  old  news  items. 

(DTRC)  Display  the  current  computer  rates. 

(DTRC)  Display  your  user  ID  and  account  number. 

(DTRC)  Send  a  file  to  the  Xerox  8700. 
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*****  Procedures  ***** 

A  procedure  is  a  group  of  control  statements  separate  from  the  job 
control  statement  file.  Calling  a  procedure  provides  a  simplified  way 
to  process  that  group  of  control  statements.  A  procedure  may  be  called 
by  a  job  repeatedly,  by  another  procedure,  or  by  itself. 

In  general,  the  "CCL  CYBER  Control  Language  Reference  Guide"  for 
NOS/BE  can  be  used  for  NOS.  It  is  available  from  User  Services.  See 
also  "NOS  2  Reference  Set  Volume  3:  System"  for  additional  features. 


***  Procedure  Directives  *** 

Procedure  directives  allow  you  to  control  procedure  processing 
options.  The  procedure  "title",  the  help  text,  and  all  "text"  and 
"message':s  may  be  in  6/1. 2-bit  upper  and  lower  case. 


•CC(n)  Specify  the  concatenation  character  for  a  procedure. 

.CORRECT, text. 

.  CORRECT=text . 

Specify  the  prompt  to  follow  an  incorrect  procedure  parameter 
entry  for  an  interactive  procedure. 

.DATA, lfn. 

Create  a  local  file  from  a  procedure. 

.DATA  is  terminated  by  another  .DATA,  an  end~of-record  (not 
.EOR),  an  end-of-file  (not  .EOF),  or  end~of_inf ormation. 

•IF,  .ELSE,  .ENDIF  can  be  used  within  the  data  lines  for 
conditional  inclusion. 

.ELSE, label . 

End  skipping  by  a  matching  .IF  or  start  skipping  to  a  matching 
.ENDIF  in  a  procedure. 


.ENDHELP. 

Mark  the  end  of  the  help  section  of  an  interactive  procedure. 
.ENDIF, label. 

End  skipping  from  a  matching  .IF  or  .ELSE  in  a  procedure. 
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.ENTER, text. 

.  ENTER=text . 

Specify  the  prompt  for  before  an  interactive  procedure 
parameter  entry. 

.EOF.  Put  an  end-of-file  into  a  file  created  by  .DATA  in  a  procedure 
or  in  the  procedure  command  record. 

.EOR.  Put  an  end-of-record  into  a  file  created  by  .DATA  in  a 
procedure  or  in  the  procedure  command  record. 

. EX. command. 

Submit  a  command  to  the  system  for  immediate  execution. 
.EXPAND, opt  ion 

End  or  resume  procedure  expansion. 

. Fn , text . 

. Fn=text . 

Specify  a  label  for  one  of  the  six  programmable  function  keys 
for  use  with  screen  mode  parameter  displays  in  an  interactive 
or  menu  procedure. 

On  a  VT-100,  these  correspond  to  keypad  keys  1-6. 


.HELP. 

.HELP, NOLIST. 

. HELP , parm. 

. HELP, parm, NOLIST. 

Specify  the  help  (upper  and  lower  case)  text  for  a  procedure 
or  parameter. 


. IC (n) 

Specify  the  inhibit  character  for  a  procedure. 

. IF, express  ion. command.  < —  note  2  terminators 
. IF, expression, label .  < —  only  1  terminator 

Conditional  expansion  of  a  procedure. 

.NOCLR, message. 

.NOCLR=message. 

Inhibit  automatic  screen  clearing  during  a  procedure. 

. NOTE, message . 

. N0TE=message . 

Specify  a  message  to  be  displayed  on  the  screen  and  in  your 
dayfile  at  the  end  of  a  procedure  call  (when  all  required 
parameters  are  supplied). 

Use  the  NOTE  command  to  display  comments  during  the  execution 
of  a  procedure. 

. PAGE, text . 

. PAGE=text . 

Specify  the  string  to  precede  the  page  number  on  the  screen. 
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PROC , pname*I"t i t le" , pi , p2, . . . , pn. ck .  < —  interactive 

PROC , pname*M"t i t le" , keyword= (sel ect ions) . ck.  < —  menu 

PROC , pname , pi , p2, . . . , pn .  < —  passive 

The  procedure  header  specifying  the  procedure  name  and 
parameters,  and  enabling  parameter  prompting. 


Parameters:  pname 


title 


selections 


the  name  of  the  procedure 
(1~7  alphanumerics ,  first  should  be 
alphabetic;  append  *1  for 
interactive,  *M  for  menu-driven; 
nothing  for  passive) 

the  procedure  title 
(default:  pname) 

up  to  50  parameters,  each  of  the 
form: 

Interactive: 

keyword"descr ipt ion"= (checklist) 
keyword 'descripti on '=( checklist) 
Passive : 
keyword 
keyword= 

keyword=defaul t 1 
keyword=def aul tl/default2 
keyword=/def aul t2 
keyword=//DATA 
keyword=//FILE 

keyword  -  1-10  alphanumeric 


checklist 


defaultl 


default2 


keyword  -  1-10  alphanumeric 

characters 

description  -  parameter  prompt 
(see  title  above) 

checklist  -  a  list  of  acceptable 
values  and  the 
parameter  syntax 
defaultl  -  1_40  chars  if  pi 
is  omitted 

default2  -  1-40  chars  if  pi  is 

specified  without 
value  or  with  the 
value  pi 

//DATA  -  the  name  of  an 

unnamed  .DATA  file 
//FILE  -  the  file  containing 

pname 

the  menu  selections  in  the  form: 

nl"descl",n2"desc2", . . . ,nn"descn" 
where  ni  -  integer  (1-10  digits) 
identifying  the  menu 
selection 

desci  -  the  menu  item  descrip¬ 
tion  (see  title  above) 
comment  keyword  (1-10  characters) 


//DATA 

//FILE 
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.PROMPT, text. 

. PROMPT=text . 

Specify  the  text  for  the  general  request  for 
procedure . 

.  SET, keywd_l  =  s trexp_l , . . . , keywd_n=s  trexp_n. 

Build  new  procedure  parameters. 


. * comment 

A  comment  in  a  procedure. 

Example:  . PROC,myproc, . . . . 

REVERT. . .myproc 

* 

.*  created  88/04/12 

.*  last  modified  88/05/20  (add  "PW" 

. *  End  of  myproc 


input  in  a 


parameter) 
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***  DTRC  Procedure  Library  *** 

Public-access  procedure  library  PROCFIL  has  been  added  to  NOS  at 
DTRC  and  will  be  searched  if  you  do  not  have  a  local  or  permanent  file 
named  PROCFIL. 

The  following  are  the  public  procedures  available  at  DTRC  as  of 
the  date  of  this  page.  For  the  current  list,  type  BEGIN, CONTENT.  See 
Appendix  I  for  further  information  on  individual  procedures. 


AUX 

AUXPRNT 

CONTENT 

COPYBFR 

FICHE 

FLR 

GETASC 

GRIPE 

HELP 

JOBCOST 

MSAUDIT 

NEWCHRG 

NEWRTNS 

NEWS 

OFLREQ 

OLDNEWS 

PUTASC 

RATES 

TAPDMP 


(interactive)  Turn  the  auxiliary  printer  on  or  off. 

(interactive)  Print  a  local  file  on  the  auxiliary  printer. 

List  the  contents  of  the  public  procedure  file. 

Restore  "randomness"  to  a  random  file  which  was  copied  using 
a  sequential  copy  such  as  COPYBF. 

Route  a  copy  of  a  local  file  to  the  microfiche  (COM). 

Compile  FTN5,  load  with  up  to  2  libraries,  and  run. 

Convert  an  8/12  ASCII  indirect  or  direct  permanent  file  to 
6/12  Display  Code. 

Submit  a  gripe  or  suggestion. 

Obtain  help  on  a  command  or  topic  (very  limited). 

Display  the  job  cost,  number  of  SRUs  and  CPU  time  in  the 
dayfile  and  file  OUTPUT. 

Sorted  CATLIST. 

Set  the  current  charge  number  on  all/some  files. 

Announcement  of  new  routines. 

Display  the  current  news. 

Off-line  Request  Generator. 

Display  the  old  news. 

Convert  a  6/12  Display  Code  file  to  8/12  ASCII  and  store  as 
an  indirect  or  direct  file. 

Display  the  current  computer  rates. 

Driver  to  execute  TAPEDMP  to  dump/analyze  a  magnetic  tape,  or 
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TPAUDIT 

Obtain  a  list  of 

the  tapes 

ass  igned 

to  you. 

TPGET 

Get  up  to  3  tapes 

to  use  on  the  CDC 

CYBER  860  or  DEC 

VAXc lus  ter. 

TPRLS 

Release  up  to  5  tapes. 

WHOAMI 

Display  your  User 

Initials 

and  account  number. 

XEROX 

Route  a  copy  of  a 

local  fi 

le  to  the 

Xerox  8700. 
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Sample  Procedure 


The  following  illustrates  a  simple  interactive  procedure  to 
a  Fortran  program  and,  optionally  execute  the  program. 


. PROC , F5*I"Compi le  and  execute 
I  ' Input 1 
B  'Binaries' 

L  ' Output ' 

LO  'List  opt i ons '  = 
GO  'Execute'  = 

FTN5,#I=I,//B=B,#L=L,#L0=L0. 

I F , $GO$ . NE . $$ . LGO . 

REVERT, NOLIST. . . F5 


Fortran  5", 

(  *F,  *N= INPUT  ), 

(  *F ,  *N=LGO  ), 

(  *F,  *N=OUTPUT  ), 
(  *N=0 ,0,0,R,A,M,S 
(  *N=  )  . 


), 


Invoking  this  procedure  with 

£5,? 


causes  the  following  dialog: 

PARAMETERS  FOR  F5  ARE  I,  B,  L,  LO,  GO 
Input?  test 
Binaries?  bfile 

Output?  <press  the  RETURN  key  for  the  default> 

List  options?  s 
Execute?  y 

The  generated  FTN5  statement  will  be: 

FTN5 , I = TEST , B=BFILE, L=OUTPUT , LO=S. 

Since  the  value  of  GO  (Y)  is  non-null,  "LGO."  will  be  executed. 


compi  1  e 
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*****  Program  Libraries  ***** 

Source  programs  and  data  may  be  in  separate  datasets  or  may  be 
stored  and  maintained  in  program  libraries.  UPDATE  creates  and 
maintains  these  libraries,  which  may  be  display  code  or  ASCII  (8/12). 


***  UPDATE  *** 

UPDATE  is  a  program  for  creating  and  modifying  a  program  library 
(PL).  In  additio-',  UPDATE  will  extract  individual  modules  for  input  to 
a  compiler  or  other  program. 

By  default,  72  columns  of  information  are  retained.  Fifteen 
additional  characters  are  retained  for  each  line:  an  9-character 
identifier,  a  6-digit  sequence  number,  i.e.,  id_seq,  and  is  often 
referenced  as  id.seq. 

UPDATE  supports  two  kinds  of  text  modules  or  decks: 

-  a  regular  deck  (beginning  with  a  DECK  directive) 

-  a  common  deck  (beginning  with  a  COMDECK  directive)  which  may  be 
included  in  decks  with  a  CALL  directive 

Each  type  includes  all  lines  following  the  deck  directive  until  the 
next  deck  or  modification  directive. 

History  information  is  retained  allowing  the  deletion, 
modification,  or  restoration  of  previous  modifications. 

See  Appendix  I  for  a  description  of  the  UPDATE  control  statement 
parami i ers . 


***  UPDATE  Directives 


An  UPDATE  directive  has  the  following  format: 
m  directive_name  [  parameters  3 

where  m  is  the  master  character  (default:  asterisk  (*)).  There  are 
five  categories  of  directives. 


**  DECK  and  COMDECK  ** 


*DECK  deck  (*DK) 

First  line  of  a  new  deck.  <deck>  is  up  to  9  characters 
except  comma,  period,  blank,  colon,  equals. 

*C0MDECK  cmdk  (*CDK) 

First  line  of  a  new  common  deck. 
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Compile  File 


*CALL  cmdk  (*CA) 

Include  the  contents  of  a  common  deck. 

’•COMPILE  p  1 ,  p2 , . . . ,  p j  .  pk , . . . ,  pn  (*C) 

Write  one  or  more  decks,  including  a  range  (pj.pk),  to  the 
compile  and/or  source  datasets.  Use  UPDATE, K  to  force  the 
output  order. 

’■CWEOF  (*CW) 

Write  an  EOF  on  the  compile  dataset  if  anything  was 
written  since  the  last  EOF. 

*WE0F  O'W) 

Write  an  EOF  on  the  compile  dataset. 

’•WIDTH  linelen,  idlen  (*WI) 

Change  the  data  and  id  length  (default:  72,4). 

’•DO,  *DONT ,  *IF ,  and  *  END  IF  are  also  available. 


**  Modification 


’•ADDFILE  lfn.name  (*AF) 

Read  creation  directives  and  text  from  file  lfn  and  insert 
after  the  specified  deck  or  line. 

’’•BEFORE  id.  seq  (*B) 

Insert  before  a  line. 

*CHANGE  oldid.newid, . . . , oldid,newid 

Change  correction  set  identifier. 

*COPY  dk, idl.seql, id2.seq2  (*CY) 

Copy  a  range  of  lines  from  deck  or  comdeck  <dk>. 

’DELETE  idl.seql  (*D)  <--  one  line 

’•DELETE  idl.seql, id2.seq2  < —  a  range  of  lines 

’'DELETE  idl.seql,  .seq2  < —  same  (short  form) 

Delete  a  line  or  a  range  of  lines. 

* IDENT  ident  (*ID) 

* I DENT  ident , B=num, K=id, U=id 

Identify  a  set  of  modifications.  You  can  specify  a 
sequence  number  bias,  and  require  that  other  modification 
sets  be  known  (K=)  or  unknown  (U=) . 

’•INSERT  id.  seq  (*I) 

Insert  after  a  line. 

(*M) 

Move  deck  <dkl>  to  follow  deck  <dk2>. 


*MOVE  dk 1 , dk2 
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’•PURDECK  dk , dk2 , .... dkj . dkk , .... dkn  (*PD) 

Permanently  remove  decks. 

*PURGE  idl , id2 , .... idj . idk , .... idn  (*P) 

Remove  the  effect  of  a  modification  set  (idi) ,  a  range  of 
datasets  (idj. idk),  or  a  set  and  all  following  (idn=*) . 

’’'RESTORE  idl.seql  (*R)  <—  one  line 

’'RESTORE  idl .  seql ,  id2 .  seq2  < —  a  range  of  lines 

Restore  a  line  or  a  range  of  lines. 

’'SEQUENCE  idl ,  id2,  .  .  .  ,  idj  .  idk,  .  .  .  ,  idn. .  (*S) 

Resequence  active  lines  and  purge  inactive  lines  in  the 
specified  decks. 

’'YANK  idl ,  id2 ,  .  .  .  ,  idj  .  idk ,  .  .  .  ,  idn 

Temporarily  delete  a  deck,  comdeck,  or  modification  set 
previously  yanked. 

’'YANKDECK  dkl  ,dk2,  .  .  .  , dkj  .dkk, . . .  ,dkn 

Temporarily  deactivate  decks. 

’•SELPURGE,  and  -'SELYANK  are  also  available. 

**  File  Manipulation  *’v 


’'COPY  name ,  idl .  seql ,  id2 .  seq2,  lfn  (*CY) 

Copy  a  range  of  lines  from  deck  or  comdeck  <name>  to  file 
<1 fn> . 

’■'READ  lfn  (*RD) 

Read  input  from  another  file. 

-'REWIND  lfn 

Rewind  a  file. 

*SKIPF  lfn,n 

Skip  record(s)  in  a  local  file. 


**  Input  Stream  Directives  ** 

*ABBREV 

Resume  recognition  of  abbreviations. 

*ENDTEXT  (*ET) 

End  a  ’'TEXT  section. 

’''LIST  (*L) 

Resume  listing  input  lines.  UPDATE, L=0  overrides  ’'LIST. 


’■'NOABBREV 


(*NA) 

Do  not  check  for  abbreviation. 
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*NOLIST  (*NL) 

Stop  listing  input  lines. 

’•TEXT  (*T) 

Treat  all  statements  between  ’-TEXT  and  ’’ENDTEXT  as  text. 
’’’SKIP  and  *ENDSKIP  are  also  available. 

**  Special  ** 

’•LIMIT  n  (*LT) 

Limit  the  output  listing  to  n  lines. 

’•/  comment 

A  comment  line. 

’•DECLARE,  ’’DEFINE,  and  ’’PULLMOD  are  also  available. 
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***  Examples 

1)  Create  a  PL: 

j  obnaml ..... 

USER , user , pw. 

CHARGE ..... 

UPDATE, P=0,C=0. 

SAVE, NEWPL=mypl . 

<eor> 

’‘DECK  DECK1 
lines  for  deck  DECK1 
*DK  DECK2 

lines  for  deck  DECK2 
*DK  DECK3 

lines  for  deck  DECK3 


2)  Interactively  extract,  compile  and  execute  deck  DECK2  from  PL  MYPL 

GET, OLDPL=mypl .  < —  get  indirect  file 

NOTE ,  uin.  /  ’’COMPILE  deck2 
UPDATE, I=uin. 

FTN5 , 1 . 

LGO. 


<—  no  OLDPL  or  COMPILE 
< —  create  indirect  file 


3)  Create  a  PL  using  a  common  deck,  compile  and  execute: 

j  obnam3 , . « . , 

USER , user , pw. 

CHARGE , .  .  .  . 

PURGE, mypl/NA. 

DEFINE, NEWPL=mypl.  <—  direct  file 

UPDATE, P=0.  <—  no  OLDPL 

FTN5 , I . 

LGO. 

<eor> 

’'‘COMDECK  COM3 

common  /  mycom  /  a,  b 
real  a,  b 
*DK  PROG3 

program  prog3 
’‘CALL  COM3 

call  sub 

print  *,  ' a, b= ' ,  a,  b 
end 

•‘DECK  SUB 

subroutine  sub 
*CA  COM3 

a  =  1 . 
b  =  2. 
return 
end 


<eoi  > 
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4)  Update  old  source  library  to  new,  compile  all  decks  and  execute: 


j  obnam4, .... 

USER, user ,pw. 

CHARGE , • • • • 

GET,OLDPL=mypl . 

UPDATE, F,N. 

FTN5 , 1 . 

LGO. 

REPLACE, NEWPL=mypl. 

<eor> 

*  I  DENT  DS0620  <— 

’■'INSERT  ALONE. 57  <— 

(Fortran  statements) 
’-DELETE  FOUR.  12, 13  <— 

(new  lines  to  replace 
<eor> 

(data  lines,  if  any) 
<eoi> 


< —  get  indirect  old  library 


< —  replace  indirect  old  library 

correction  must  be  unique  (ini t ial s , date) 
correct  deck  ALONE  by  insert  after  line  57 

correct  deck  FOUR  replacing  lines  12-13 
deletions  -  optional) 


5)  Select  routines  from  source  subroutine  library  and  compile  with  your 
own  program: 

j  obnam5 , « • . . 

USER, user ,pw. 

CHARGE, .... 

FTN5.  < —  compile  your  own  programs 

ATTACH, thatpl/UN=NSYS. 

UPDATE, P=thatpl,Q,L=0. 

FTN5.I. 

LGO. 

<eor> 

(own  Fortran  decks) 

<eor> 

’VC  rtnl , rtn6 . rtn8  < —  select  decks  RTN1 ,  6,  7,  8  from  library 

<eor> 

(data  records,  if  any) 

<eoi> 
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it  it  it  it  it 


Object  Libraries 


it  it  it  it  it 


LIBEDIT  and  LIBGEN  are  utilities  for  creating  and  maintaining 
libraries  of  absolute  and  relocatable  object  modules.  These  libraries 
can  then  be  used  by  the  loader  to  locate  the  program  to  execute  or  the 
subprograms  to  be  loaded  with  your  program. 


See  Appendix  I  for  the  LIBEDIT  and  LIBGEN  control  statements. 


*** 

The  following  are  used 
directives : 

rid  -  record  identifier 
format 
type/name 
name 

it 


LIBEDIT  Directives  *** 
in  the  descriptions  of  the  LIBEDIT 


meaning 


the  record  has  this  type  and  name 

the  record  has  this  name  and  the 
default  type 

end-of-file  (-'BEFORE  only) 


gid  -  group  identifier 
format 
type/name 
name 

typel/namel-type2/name2 
type  1 /name l~name2 
namel~name2 

type/name-* 

name-* 

type/* 

* 


meaning 

the  record  with  this  type  and  name 

the  record  with  this  name  and  the 
default  type 

a  group  of  records 

a  group  of  records  of  typel 

a  group  of  records  with  the  default 
type 

all  records  of  this  type  beginning 
with  <name> 

all  records  of  the  default  type 
beginning  with  <name> 

all  records  of  this  type 

all  records 


0 


insert  a  zero-length  record 
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The  following  are  some  of  the  LIBEDIT  directives.  Directives  start 
with  an  asterisk  in  column  1,  followed  by  the  directive  name  (or 
abbreviation).  Directives  can  be  continued  (gid  entries  cannot  be 
split).  For  example: 

*BEFORE, ovl/pl ,ovl/p2 
ovl/p3 


’'ADD  LIBn, gidl , gid2 ,.. . 

Append  records  to  a  record  group. 

Parameters:  LIBn  -  a  record  group  (from  a  CATALOG  listing) 

(1  <=  n  <=  63) 

gidi  -  records  from  the  current  replacement  file 
to  be  appended 

*BEF0RE  rid, gidl, gid2, .. .  (*B) 

Insert  records  before  a  specified  record. 


*BUILD  dname 

Build  a  directory  at  the  end  of  the  new  file. 

Parameters:  dname  -  the  name  for  the  directory  record 

(1-7  alphanumer ics) 

’'COMMENT  rid  comment 

Add  a  comment  to  the  prefix  table. 

Parameters:  comment  -  up  to  70  characters  with  excess 

truncated 

’"'COPY  Copy  the  new  file  to  the  old  file  after  editing. 

Remarks:  ’“'COPY  is  the  same  as  LIBEDIT, ...  ,C. 

’'DATE  rid  comment 

Add  the  date  and  a  comment  to  the  prefix  table. 

Parameters:  comment  -  up  to  70  characters  with  the  ex^eos 

truncated 

’■'DELETE  gidl, gid2,  .. .  (*D) 

Do  not  copy  the  specified  records  to  the  new  file. 
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’'FILE  Ifn  The  name  of  the  file  containing  the  replacement  records. 

Parameters:  lfn  -  use  *  for  the  replacement  file  from  the 

LIBEDIT  command  (B=) 

(default:  LGO) 


* IGNORE  gidl , gid2, . . . 

Ignore  specified  records  in  the  replacement  file. 


Examples:  ’'FILE  myrecs 

* IGNORE  D-* 

A —  ignore  all  records  from  D  to  the 
end-of-f ile 


’•INSERT  rid, gidl, gid2,  .. .  (*I,  ’-AFTER,  *A) 

Place  the  replacement  records  after  the  specified  groups  in 
the  new  file. 


*LIBGEN  record_name 

Generate  a  user  library  (using  LIBGEN)  after  processing. 

Parameters:  record_name  -  the  name  of  the  new  user  library 

directory  record 

Remarks:  ’'LIBGEN  overrides  ’'VERIFY. 


’•LIST  list_file,  list_opt 

Specify  the  list  file  and  the  list  options. 

Parameters:  list_file  -  same  as  LIBEDIT, L= 

list_opt  -  same  as  LIBEDIT, LO= 

*NEW  newfile 

Specify  the  name  of  the  new  file. 

Parameters:  newfile  -  same  as  LIBEDIT, N= 

*N0INS  Prevent  the  insertion  of  unreplaceable  records. 

Remarks:  same  as  LIBEDIT, NI 

’■'NOREP  lfnl ,  lfn2,  . . . 

Do  not  automatically  replace  records  from  the  specified  files. 

Remarks:  Records  from  these  files  can  be  copied  to  the 

new  file  only  by  using  *  AFTER ,  "'BEFORE,  ’-INSERT, 
or  ’’'REPLACE. 
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*NOREW  Do  not  rewind  the  old  or  new  files. 
Remarks:  Same  as  LIBEDIT.NR. 

*0LD  oldfile 

Specify  the  name  of  the  old  file. 
Remarks:  Same  as  LIBEDIT,P=. 


“RENAME  rid, name 

Rename  a  record. 

Parameter ^ :  rid  -  the  name  of  the  replacement  or  old  file 

record  to  be  renamed 

name  -  the  new  name 


"'REPLACE  gidl  ,gid2,  .  .  . 

Replace  old  file  records  with  records  from  the  replacement 
file. 

Examples:  The  old  and  replacement  files  each  contain 

records  A,  B,  C,  D.  To  replace  only  C  and  D,  use 
either  of  the  following: 

*FILE  replfyl  ’’'FILE  replfyl 

*N0REP  replfyl  ’’'IGNORE  A~B 

’•REPLACE  C-D 


’’'REWIND  lfn 

Rewind  a  file  before  and  after  editing. 

*TYPE  type  (’-NAME) 

Set  the  default  record  type. 

Parameters:  type  -  the  record  type  (ABS,  OPL,  OVL,  PROC,  REL, 

TEXT,  ULIB) 

*VFVLTB  Verify  the  new  file  against  the  old  file  using  VFYLIB. 

Remarks:  Overridden  by  ’'LIBGEN. 
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***  DTRC  Object  Libraries  *** 

The  following  object  libraries  have  been  added  to  NOS  at  DTRC: 

DTLIB/UN=NSYS  -  Subprograms  written  or  maintained  by  the 

Computer  Center 

To  use:  ATTACH, DTLIB/UN=NSYS . 

LDSET, LIB=DTLIB .  -or-  LIBRARY , DTLIB . 
LGO. 

UTILITY/UN=NSYS  -  Programs  written  or  maintained  by  the 

Computer  Center 

To  use:  ATTACH, UTILITY/UN=NSYS. 

LIBRARY, UTILITY, 
prognam. 


***  Examples 

1)  Create  a  library  of  subprograms. 

ATTACH, mysubss . 

FTN5, I=mysubss,0PT=2,L-0. 

PURGE, mysubs/NA. 

DEFINE, mysubs/CT=PU. 

LIBGEN.P^mysubs . 


2)  Create  a  library  of  all  subprograms  from  an  UPDATE  library. 

ATTACH, OLDPL=mypl . 

UPDATE, F. 

FTN5 , I , L=out2 , 0PT=2 . 

PURGE, mysubs/NA. 

DEFINE, mysubs/CT=PU. 

LIBGEN, P=mysubs . 

ROUTE, out2,DC=PR. 
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3)  Add  a  subprogram  to  an  existing 
in  alphabetical  order. 

Direct  files 


j  obnam3 . 

USER , user , pw. 

CHARGE , • .  •  • 

FTN5,OPT=2. 

ATTACH, subs . 

PURGE, NEW/NA. 

DEFINE, NEW. 

LIBEDIT, P=subs , U, 1=0. 
PURGE, subs . 

CHANGE. subs=NEW/CT=PU. 
<eor> 

<FTN5  subprograms  source> 


library  and  have  the  output  list 


Indirect  files 


j  obnam3 . 

USER , user ,pw. 
CHARGE, .... 
FTN5,0PT=2. 
GET , subs . 


LIBEDIT, P  =  subs,U,  1  =  0. 
REPLACE, NEW=subs. 

<  eor  > 

<FTN5  subprograms  source> 


4)  Delete  subprogram  BADSUB  from  an  existing  library. 
GET , OLD=subs . 

LIBEDIT, B=0, 2. *DELETE  REL/badsub 
REPLACE, NEW=subs. 
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*****  Loader  ***** 

The  loader  is  responsible  for  loading  all  programs,  resolving  any 
external  references,  and  optionally  initiating  execution. 

Once  loading  of  a  program  is  started,  no  other  control  statements 
may  interrupt  the  load  sequence.  For  instance,  a  'LOAD,lfn.'  statement 
may  only  be  followed  by  another  'LOAD, lfnl.'  or  one  of  the  loader 
control  statements  or  HAP,  REDUCE  or  others  listed  in  the  Loader 
Reference  Manual. 


*  *  *  Types  of  Loading  * * * 

Loading  differs  according  to  whether  the  input  is  one  or  more 
object  modules  or  a  single  memory  image  module.  Loading  of  object 
modules  can  involve  overlay  or  segment  generation  and  can  result  in  one 
or  more  memory  image  modules.  A  basic  load  results  in  one  memory  image 
(absolute)  module. 


Object  module  loading  One  or  more  object  modules  are  loaded,  libraries 

are  searched  for  the  external  references, 
addresses  are  adjusted,  and  a  memory  image 
module  may  be  produced. 

Memory  image  loading  This  is  a  special  case  because  no  external 

linkage  or  address  adjustment  is  required. 


Basic  loading 


All  object  code  is  loaded  at  the  same  time, 
resulting  in  a  single  memory  image  module. 
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Segmentation  For  large  programs,  segmentation  should  be  used 

to  divide  the  program  into  several  memory  image 
modules,  called  segments. 

With  segmentation,  only  those  portions  of  the 
program  needed  at  a  given  moment  are  in  memory. 
Different  memory  image  modules  reside  in  the 
same  area  of  memory  at  different  times. 
Depending  on  execution  requirements,  different 
memory  image  modules  are  loaded  dynamically. 

Features : 

-Segmentation  allows  any  number  of  levels, 
limited  only  to  a  total  of  4093  segments. 

-After  segments  have  been  generated,  their 
loading  is  automatic. 

-References  between  segments  may  be  upward 
or  downward. 

-At  execution  time,  a  resident  program  is 
loaded  which  loads  the  root  segment. 
Thereafter,  it  loads  the  other  segments  as 
required. 


Overlay  generation  An  overlay  is  a  collection  of  executable 

programs  which  are  called  into  memory  at 
execution  time,  according  to  an  overlay 
structure  which  is  defined  in  the  source  code. 


Overlay  capsule 

generation  For  large  programs,  overlay  capsules  may  be 

used  to  divide  the  program  into  an  absolute 
main  program  and  one  or  more  capsules  which 
are  loaded  and  unloaded  by  the  user. 

Because  overlays  and  overlay  capsules  require  statements  in  your 
program  to  cause  the  overlaying  to  take  place,  they  are  not  recommended. 
Instead,  use  segmentation,  which  is  controlled  by  directives  external 
to  your  program. 
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***  Loader  Control  Statements  *** 

See  Appendix  I  for  the  syntax  of  the  following  control  statements 

used  to  load  a  program. 

EXECUTE  Complete  loading,  fill  unsatisfied  references  by  system  (and 
user)  library  search,  generate  load  map  and  execute  the 
program. 

LDSET  Set  any  of  several  loader  options  for  the  current  load  only. 

LGO  Load  and  execute  the  default  compiler  binary  output  file. 

LIBLOAD  Load  modules  from  specified  library  which  contains  the 
specified  entry  points. 

LOAD  A  list  of  files  whose  contents  are  to  be  loaded. 

name  Load  and  execute  binary  program  or  procedure  in  local  file 

<name> . 

N0G0  Complete  the  loading  c'  a  program,  including  generating  load 

map,  but  do  not  execute. 

SATISFY  Satisfy  unsatisfied  externals  prior  to  normal  satisfaction  at 
load  completion. 

SLOAD  Selectively  load  modules  from  local  file  <lfn>. 


In  addition,  the  following  Loader-related  control  statements  are 
also  available: 

LIBRARY  Specify  a  set  of  global  libraries  to  be  searched  for  externals 
and  programs  and  the  order  in  which  the  libraries  are  to  be 
searched. 

MAP  Specify  the  global  default  option  for  load  maps. 

REDUCE  Turn  the  reduce  flag  on  or  off. 

RFL  Set  field  length  for  the  next  program  execution. 
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***  Segmentation  *** 

To  implement  segmentation,  a  separate  directive  record  is  prepared 
to  describe  the  tree  structure.  The  modules  will  be  loaded 
automatically  as  needed.  Job  field  length  is  adjusted  dynamically 
if  the  program  has  no  blank  common,  has  no  level  statements  and  is  not 
in  RFL  mode. 

All  necessary  Record  Manager  routines  must  be  in  the  root  segment. 
Other  LOAD  and  LDSET  statements  follow  the  SEGLOAD  statement: 

SEGLOAD, 1=1 fndir,B=lf nabs, L0=1 fnout . 


SEGLOAD  Directives 


x  TREE  y 

To  define  a  tree  structure. 

<y>  may  be  comma-separated  list  of  other  trees 

(pre-def ined) ,  segments  or  names  of  individual  subprograms 

to  be  assigned  a  common  starting  address. 

x  TREE  f- (c , d) 

To  indicate  branching  of  the  tree  use  -,  then  all 
following  items  are  enclosed  in  parentheses. 


c  INCLUDE  a,b 

To  assign  programs  <a>  and  <b>  to  segment  <c>. 

Copies  of  a  routine  may  be  in  different  segments. 

c  GLOBAL  coml,com2 

To  establish  named  commons  at  desired  segment. 

Reference  name  to  left  of  directive  must  be  defined  by  a 
previous  directive. 

c  GLOBAL  coml , com2~save 

To  save  global  block  on  disk  for  later  calls  to  the 
segment  which  contains  it. 

END  ept 

Should  be  the  list  directive  in  the  record,  where  <ept>  is 
the  entry  of  the  main  program  in  the  root  segment. 
Non-fatal  error  if  omitted. 
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***  Segmentation  Cautions  *** 

1.  To  develop  a  segmented  job,  several  runs  may  be  required,  so 
relocatable  object  code  should  be  cataloged.  Common  blocks  and  Record 
Manager  routines  may  need  to  be  INCLUDEd  in  lower  segments  to  operate 
properly. 


2.  The  load  map  must  be  checked  carefully  for  any  duplicate  common 
block  entries.  Each  common  block  which  is  referenced  in  more  than  one 
segment  must  be  put  into  a  global  at  the  nearest~to-the-root  segment. 

If  any  common  block  appears  more  than  once  without  "safe",  a  global  is 
required  to  eliminate  duplicate  storage  areas.  If  input/output  is 
performed  in  several  segments,  some  Record  Manager  common  blocks  may 
be  multiply  defined  (e.g.,  AOB.RM  or  Q8.I0.). 

Subfields  in  SEGLOAD  directives  which  contain  any  of  the  special 
characters  ,  -  (  )  or  which  start  with  a  $  must  be  defined  as  literals 
(i.e.,  delimited  by  $...$).  Embedded  $  is  represented  by  $$,  thus, 

$TAN  must  be  specified  as  $$$TAN$  . 

When  Record  Manager  common  is  global  to  a  root  segment,  the  loader 
may  detect  errors  in  initializing.  If  so,  an  INCLUDE  directive  will  be 
required  to  move  the  RM  routines  to  that  segment  (e.g., 

' MYMAIN  INCLUDE  INC0M='  ). 


3.  Directives  must  not  go  beyond  column  72  of  a  line.  They  may  be 
broken  almost  anywhere  and  continued  on  the  next  one  or  more  cards/ 
lines.  The  continuations  have  a  comma  (,)  in  column  1  as  the 
continuation  signal,  then  the  directive  is  continued  starting  in 
col umn  2 . 

Continued  directives  should  be  avoided,  if  possible,  to  improve 
readabi 1 i ty . 


A.  FTN5  users  should  avoid  passing  external  references  as  subprogram 
arguments.  When  the  external  is  not  in  the  root  segment  or  the  same 
segment  as  the  call,  execution  will  generate  the  fatal  error  message 
'NON-EXECUTABLE  WORD  LOADING  A  SEGMENT'. 
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Compile,  Load  and  Catalog  Absolute  Program 


**  Simple  Load 

j  obname , . . . . 

USER, user, pw. 

CHARGE , . . . . 

FTN5 , OPT=l . 

LOAD, LGO. 

NOGO,myprog.  < —  absolute  module  into  MYPROG 

REPLACE, myprog. 

<eor> 

program  myprog 

<eoi> 


**  SEGLOAD  ** 


j  obname , . . . . 

USER, user ,pw. 

CHARGE ..... 

FTN5 , OPT=l . 

REPLACE, LGO=mysglgo. 

PURGE , mys  egnu/NA. 

DEFINE, mysegnu. 

SEGLOAD , B=mys  egnu . 

LOAD, LGO. 

NOGO. 

PURGE , mys  eg 1 /NA . 

CHANGE , mys  eg 1 =my s  egnu . 
<eor> 

<  FTN5  source  program  > 
<eor> 

<  SEGLOAD  directives  > 
<eoi> 


name/code 


< —  save  relocatable  modules  for 
possible  re-segmentation 
< —  MYSEGNU  for  absolute  segments 


< —  absolute  segments  onto  MYSEGNU 
< —  replace  old 
<—  copy  of  MYSEGL 


** 


Interactive  Simple  Execution 


GET, mys or . 

FTN5 , I=mysor , L=myout , 0PT=1 . 

LDSET,MAP=S.  < —  to  see  any  missing  routines 

LGO. 


ROUTE , myout , DC=PR . 


< —  print  the  compilation  listing 


Page  9-6~8 


RevO 


90/09/30 


***  Object  Program  Execution  *** 

**  COBOL5  *** 

The  following  system  parameters  may  be  added  to  the  execution 
statement  of  a  COBOL  68  program  to  display  in  the  dayfile  certain 
information  about  the  execution: 

*CORE  Displays  the  maximum  amount  (in  octal)  of  memory  used. 

*MSGS  Displays  the  Sort/Merge  summary  messages. 

*TIME  Displays  the  execution  CPU  time. 

For  example,  LGO,*TIME,*CORE,*MSGS. 


**  Fortran  ** 

The  following  system  parameters  may  be  added  to  the  execution 
statement  of  a  Fortran  77  program  to  control  the  execution: 

5'DA=i  + j  +  k+l+m+n+o 

Specify  the  subscript  limits  for  Post  Mortem  Dump.  For 
example,  LG0,*DA=4+2. 

dumps  1-  and  2-dimensional  arrays  with  the  maximum  first 
dimension  of  A  and  second  of  2. 

(default:  *DA-20+2+l+l+l+l+l) 

*0P=op 

Specifies  the  format  and  destination  of  the  Post  Mortem  Dump, 
op  meaning 

A  all  active  routies  are  included  in  the  dump 

F  output  to  file  PMDUMP  if  OUTPUT  is  connected 

(interactive  only) 

T  a  condensed  form  of  the  output  is  displayed 
at  the  terminmal  if  OUTPUT  is  connected 
(interactive  only) 

For  example,  LG0,*0P=AF. 

(defaults:  interactive:  *OP=F;  batch:  *0P=) 

*PL=pl  The  maximum  number  of  lines  written  to  file  OUTPUT.  This 

overrides  the  value  specified  or  implied  (5000)  at  compilation 
time  by  the  PL  parameter  of  the  FTN5  statement.  This  is 
placed  after  any  file  replacements  in  the  execute  statement 
For  example,  LGO, *PL= 10000. 

LG0 ( , ,MYFILE1 , MYFILE2 , *PL=600) 

User  parameters  follow  any  system  parameters. 
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*****  Other  Software  ***** 

***  Accessing  Other  Software  *** 

Programs  obtained  from  other  vendors  are  normally  execute-only, 
access  them,  you  normally  need 


To 


ATTACH, program/UN=un,M=E. 
-or- 

GET,program/UN=un. 


< —  A  below 
< —  G  below 

where  un  currently  is  APPLLIB,  LIBRARY  or  NSYS. 


***  UN=APPLLIB  *** 

As  of  the  date  of  this  page,  UN=APPLLIB  contains: 
GPSS  A  General  Purpose  Simulation  System 

PERT78  A  Pert/Time 


***  UN=LIBRARY  *** 

As  of  the  date  of  this  page,  UN=LIBRARY  contains: 


BETONOS 

A 

NOS/BE  to  NOS  command  help  (HELPBE)  and  NOS/BE  file  loader 
(BELOAD) 

DTLIB 

A 

DTRC  subprogram  library 

HOTSPOT 

G 

Analyze  a  program  for  inefficient  code 

PROCFIL 

G 

DTRC  procedure  library 

SIMII5 

A 

Simscript  II. 5 
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***  UN=NSYS 


*** 


As  of  the  date  of  this  page,  UN=NSYS  contains: 


CALCFN 

G 

Calcomp  Functional  Package 

CALC936 

G 

Calcomp  936  Subroutine  Package  (7-track 

tapes  only) 

DISSPLA 

G 

DISSPLA  Graphic  Subroutine  Package 

IMSLM 

A 

IMSL  10  Mathematical  Subroutine  Library 

IMSLSS 

A 

IMSL  10  Special  Function  and  Statistical 

Subroutine  Library 

UNPACK 

G 

Simultaneous  Linear  Algebraic  Equation  Solver  Package 

UTILITY 

G 

DTRC  program  library 
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*****  Appendix  H 


***  CDC  NOS/VE  SCL  Commands  *** 

CDC  NOS/VE  SCL  commands  have  the  following  general  syntax: 

statement  name  -or- 
plural  statement  name  -or- 
statement  name  abbreviation 
parameter  name=value  list 
parameter  name=value  list 

parameter  name=value  list 

function  name 

(parameter  namervalue  list, 

parameter  name:value  list) 

statement  name  -or-  plural  statement  name 

is  the  name  of  the  utility  to  be  performed.  It  has  the  form 
aaaaa_bbb_ccc_ddd_eee_. . . 

statement  name  abbreviation 

is  the  short  form  of  the  statement  name  and  is  the  first  three 
characters  followed  by  the  first  character  after  each 
e.g.  , 

aaabcde. . . 

parameter  name=value  list 

(parameter  name:value  list,  ...  parameter  name:value  list) 

is  the  list  of  parameters  for  the  utility  or  function. 

function  name 

is  the  name  of  the  function  to  be  performed.  E.g., 

5STRING 

(VALUE:  any, 

FORMAT : keyword, 

MAX_STRING: integer) 
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***  Value  Descriptors  *** 

The  following  value  descriptors  are  used  in  this  appendix: 

boolean  One  of: 

TRUE  (synonyms:  ON,  YES) 

FALSE  (synonyms:  OFF,  NO) 

date_ISO  The  date  in  ISO  format: 
yy-mm-dd 

date_time  The  date  (and  time)  in  one  of  the  following  formats: 

YY YY-MM-DD. hh. mm. ss 

YYYY-MM-DD  <—  assumes  .00.00.00  (midnight) 

file  A  filename, 

keyword  A  specific  word  or  phrase, 

list  of  ... 

One  or  more  value.  If  more  than  one,  they  are  separated  by 
a  comma  or  space. 

name  An  SCL  or  user  name. 

string  A  string  of  characters. 

aa...a  -  1  or  more  alphabetic  characters 

axx . . . x  -  1  or  more  alphanumeric  characters,  the  first 

alphabetic 

xxx... x  -  1  or  more  alphanumeric  characters 

nn...n  -  1  or  more  decimal  (unless  otherwise  stated)  digits 

nn...nB  -  1  or  more  octal  digits 

nn...nD  -  1  or  more  decimal  digits 
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***  Condition  Handling  *** 


You  may  establish  handlers  for  t: 2  following  conditions  (severity 
error  level  ERROR  or  greater) : 


PROGRAM_FAULT 

LIMIT_FAULT 

COMMAND_FAULT 

ANY_FAULT 

EXIT 


Program  terminated  in  error 

Job  resource  limit  reached 

Command  syntax  error 

Any  of  the  above  conditions  occurred 

A  procedure  is  terminating 


PAUSE (INTERRUPT)  Pause  break  (terminal  interrupt)  was  entered 

Without  a  condition  handler,  a  batch  job  will  terminate  and  an 
interactive  job  will  prompt  you  for  another  command. 

Within  the  condition  handler,  you  may  include 

CONTINUE  to  continue  the  job  with  the  command  following  the 

one  that  caused  the  error 

CONTINUE  RETRY  to  retry  the  command  that  caused  the  error 

When  an  error  occurs,  the  current  block  is  searched  for  the  most 
recent  WHEN  block  for  that  condition.  For  example, 


WHEN  PROGRAM_FAULT  DO 

PUT_LINE  1  Program  terminated  abnormally.' 
WHENEND 


The  CANCEL  command  is  used  to  cancel  one  or  more  condition  handlers. 
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***  Some  Common  Parameters  *** 

The  following  parameters  are  used  in  many  SCL  commands.  If  they 
have  a  different  meaning  or  a  special  condition,  it  will  be  mentioned 
in  the  individual  description. 

BINARY_OBJECT=f ile  (BO,  BINARY,  B) 

The  file  to  receive  the  binary  object  code  produced  by  a 
compiler.  To  omit  generation  of  the  binary,  use  B=$NULL. 

(default:  SLOCAL.LGO) 

DEBUG_MODE=bool ean  (DM) 

Specify  if  debug  mode  is  to  be  used. 

(default:  OFF) 

ERROR=f i le  (E) 

The  file  to  which  error  messages  are  written. 

(default:  SERRORS) 

ERROR_LEVEL=keyword  (EL) 

The  minimum  error  severity  level  to  be  reported, 
ab  option 


I  INFORMATIONAL 
T  TRIVIAL 
W  WARNING 
F  FATAL 
C  CATASTROPHIC 
NONE 

Each  command  supporting  this  will  list  the  options 
available  and  the  default. 


FAMILY=name  or  string  (F) 

The  disk  family  where  the  file  is  stored.  At  DTRC,  there 
is  only  one  family  (NVE) ,  so  this  parameter  can  be  omitted. 

FILE-file  (F) 

The  file  to  be  processed. 


FILE-list  of  file  (F) 

One  or  more  files  to  be  processed. 
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INPUT=f i le  (I) 

The  input  file. 

(defaults:  compilers:  SINPUT 

others:  $COHMAND) 


JOB_NAME=name  (JN) 

The  name  of  the  batch  job. 


LTST=f i le  (L) ,  Nam 

The  listing  file.  To  omit  generation  of  this  file,  use 
L=$NULL. 

(default:  $LIST) 


LOCAL_FILE_NAME=name  (LFN) 

The  local  file  name  used  by  subsequent  commands  to  refer 
to  an  attached  file. 


0UTPUT=f ile  (0) 

The  output  file.  To  omit  generation  of  this  file,  use 
0=$NULL. 

(default:  50UTPUT) 


PASSWORD=keyword  or  name  or  string  (PW)  (attribute:  SECURE) 
The  password  for  access  to  a  file. 


PR0L0G=f i le  (P) 

Some  commands  allow  you  to  execute  subcommands  each  time 
you  execute  the  command.  Normally,  these  subcommands  are 
in  this  file. 

(default:  $NULL) 


RUNTIME_CHECKS=1 ist  of  keyword  (RC) 

Used  by  compilers  to  control  execut ion~t ime  checking, 
rc  meaning 


I 


R  runtime  range  checking  for  character  substring 

expressions 

S  runtime  range  checking  for  substring  expressions 

NONE  no  options 
ALL  both  R  and  S 
(default :  NONE) 
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SCOPE=keyword  (S)  (attribute:  BY_NAME) 
The  scope  of  the  variable. 


keyword 


meaning 


LOCAL 

XDCL 

XREF 

ENVIRONMENT 

JOB 

TASK 


UTILITY 


PUSH 


local  to  the  current  block 

externally  declared 

externally  referenced 

(cannot  have  an  initial  value) 

local  to  the  block  in  which  it  is  defined 

global  to  the  job  block 

local  to  the  current  block 

(if  a  task  block)  -or* 

in  the  task  block  that  most  directly  called 

the  current  block  -or- 

in  the  job  block 

local  to  the  current  block 

(if  a  utility  block)  -or- 

in  the  utiltiy  block  that  most  directly 

called  the  current  block  -or- 

in  the  job  block 

if  defined,  it  is  suspended  (pushed) 

if  not  defined,  is  it  created  with  scope  of 

ENVIRONMENT 


Each  command  supporting  this  will  list  the  options 
available  and  the  default. 


STATUS=s tatus  variable 

Causes  continues  execution  when  an  abnormal  condition 
occurs  (except  command  syntax  error).  Without  STATUS, 
the  succeeding  commands  in  the  block  are  skipped. 

Before  using  the  STATUS  parameter,  you  must  define  a 
variable  of  type  status.  For  example. 

s tatus =my_s tatus 

Variable  MY_STATUS  may  then  be  interrogated  and  the  flow 
of  commands  altered  as  desired. 

The  status  variable  is  a  record  and  contains: 

NORMAL  -  TRUE  =>  the  command  completed  without  an 

error 

FALSE  =>  either  the  command  failed,  or  it 
completed  successfully  but  there 
is  more  information  about  the 
compl et i on 

CONDITION  -  the  condition  code  of  the  diagnostic 

message  —  undefined  if  the  NORMAL  field  is 
TRUE. 
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TEXT  -  a  string  (up  to  256  characters)  with  the 

diagnostic  message  —  undefined  if  the 
NORMAL  field  is  TRUE. 

STATUS  has  attributes:  BY_NAME,  VAR. 

SUBSTITUTION_MARK=keyword  or  string  (SM) 

A  single  character  used  within  a  statement  to  delimit  the 
text  to  be  substituted.  It  cannot  be  any  character  that 
is  a  valid  SCL  name.  Corresponding  pairs  must  appear  on 
the  same  line,  if  not,  an  end-of-line  is  treated  as  the 
substitution  mark.  Two  consecutive  marks  appear  as  a 
single  mark  in  the  substituted  string. 

NONE  -  no  substitution 
(default:  NONE) 

SYSTEM_JOB_NAME=name  (SJN) 

The  system-supplied  name  of  a  batch  job. 

TERMINATION_ERROR_LEVEL=keyword  (TEL) 

Minimum  severity  level  for  returning  abnormal  status 
ab  option 


I  INFORMATIONAL 
W  WARNING 
F  FATAL 
C  CATASTROPHIC 
(normal  default:  FATAL) 


TITLE=string  (T)  (windowing) 

The  title  of  the  window. 

Each  command  supporting  this  will  list  the  default. 
TITLE  has  attribute:  BY_NAME. 

USER_JOB_NAME=name  (UJN,  JOB_NAME,  JN) 

The  user-supplied  name  of  a  batch  job. 


WIDTH=integer  (W)  (windowing) 

The  width  of  the  window  (in  characters)  . 

Each  command  supporting  this  will  list  the  range  and 
def aul t . 


WIDTH  has  attribute:  BY  NAME. 
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X=integer  (windowing) 

The  X-coordinate  of  the  upper  left-hand  corner  of  the 
window. 

(default:  5;  range:  2-80) 


X  has  attribute:  BY  NAME. 


Y=integer  (windowing) 

The  Y-coordinate  of  the  upper  left-hand  corner  of  the 
window. 

(default:  5;  range:  2-30) 

Y  has  attribute:  BY  NAME. 
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***  Summary  of  CDC  NOS/VE  SCL  Commands  *** 

The  following  are  NOS  SCL  statements,  except  as  indicated  by: 

(DTRC)  A  command,  procedure  or  program  added  at  DTRC 
(UTILITY  subcommand) 

A  subcommand  used  in  the  definition  of  a  utility 

(<utility>  subcommand) 

A  subcommand  of  the  utility  <utility> 

(VEIAF)  NOS/VE  InterActive  Facility 

SCL  statements  for  certain  NOS/VE  features  are  indicated  by: 

(CRM)  Cyber  Record  Manager 

(Loader)  Loader  control  statements 

In  the  syntax  descriptions,  parameters  preceding  " - "  are 

required;  those  following  are  optional.  If  a  command  description  has 

several  " - "  lines,  the  first  means  the  parameters  following  it  are 

optional;  the  second  means  those  following  are  required;  the  third  that 
those  following  are  optional;  etc. 

Because  parameters  may  be  specified  either  positionally  or  by 
keyword,  all  parameters  are  listed  in  the  Syntax  section,  but  are  not 
necessarily  described  in  the  Parameters  section.  Some  common  parameters 
are  described  in  the  preceding  section  of  this  Appendix. 


ANALYZE_OB JECT_LIBRARY 

Begin  an  ANALYZE_OB JECT_LIBRARY  utility  session. 

Syntax:  ANALYZEJDB JECT_LIBRARY  -or- 

ANAOL 


L  or  LIBRARY=f ile 

STATUS=status  variable 

Parameters:  L  -  object  library  or  object  file  to  be  analyzed 

(default:  you  must  use  USE_LIBRARY  subcommand 
to  specify  it) 

Subcommand  prompt:  AOL/ 


Similar  commands: 


NOS:  ITEMIZE 
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ANALYZE_PROGRAM_DYNAMICS 

Measure  program  execution  characteristics  and  restructure 
program  as  a  single  load  module. 

Syntax:  ANALYZE_PROGRAM_DYNAMICS  -or- 

ANAPD 

TT  or  TARGET_TEXT=  file 

RM  or  RESTRUCTURED  MODULE=f i le 


F  or  FILES  or 

FILE=1 ist  of  file 
P  or  PARAMETER=string 
L  or  LIBRARIES  or 

LIBRARY=list  of  file 
M  or  MODULES  or 

MODULE=list  of  program-name 
SP  or  STARTING_PROCEDURE=program_name 
RMN  or  RESTRUCTURED_MODULE_NAME=program_name 
RC  or  RESTRUCTURING_COMMANDS=f i le 
STATUSES tatus  variable 


ANY_MAIL  (DTRC)  Check  for  mail. 

Syntax:  ANY_MAIL  -or- 

ANYM 


DO  or  DISPLAY_OPTION=keyword 
STATUS=status  variable 

Parameters:  DO  -  display  options 

ab  option  meaning 


B  BRIEF  only  a  message 

F  FULL  list  of  unread  letters 

(default:  B) 

See  also:  CHECK_F0R_MAIL 

Similar  commands:  VMS:  MAIL 

Examples:  /any_mail 

You  have  new  mail 


/  anym 

You  have  no  unread  mail 


90/09/30 


RevO 


Page  H-ll 


/ anym  f 

1.  date  time  sender  subject  size (bytes)  codes 

2.  date  time  sender  subject  size (bytes)  codes 

A —  codes:  C  (confirm  delivery) 

R  (reply  requested) 

ATTACH_FILE 

Attach  a  file  to  a  job. 

Syntax:  ATTACH_FILE  -or- 

ATTF 

F  or  FILE=f ile 


LFN  or  LOCAL_FILE_NAME=name 

AM  or  ACCESS_M0DE  or 

ACCESS_MODES=list  of  keyword 
EEPN  or  ERROR_EXIT_PROCEDURE_NAME  or 
EEN  or  ERROR_EXIT_NAME=name 
EL  or  ERROR_LIMIT= integer 

FB  or  FREE_BEHIND=boolean 

JWC  or  JOB_WRITE_CONCURRENCY=boolean 

MC  or  MESSAGE_CONTROL= list  of  keyword 

OP  or  OPEN_POSITION=keyword 

PW  or  PASSWORD=keyword  or  name 

PR  or  PRIVATE_READ*boolean 

RV  or  RECORDED_VSN=list  of:  string  or  name 

SA  or  SEQUENTIAL_ACCESS=boolean 

SM  or  SHARE_MODE  or 

SHARE_MODES=l ist  of  keyword 
TS  or  TRANSFER_SIZE= integer 
VOA  or  V 0LUME_0 V ER F LO W_AL  LO WED=  boolean 
W  or  WAIT=boolean 

STATUS=status  variable 

See  also:  CREATE_FILE;  DETACH_FILE 

Similar  commands:  COS:  ACCESS;  ACQUIRE 

NOS:  ATTACH;  FILE;  GET 
VMS:  no  local  file  concept 

Examples:  /attf , in, prog_data 

ATTACH_JOB 

Reconnect  your  terminal  to  a  previously  disconnected  job. 

Syntax:  ATTACH_JOB  -or- 

ATTJ 


JN  or  J0B_NAME=name 

STATUS=status  variable 
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Remarks : 


Examples : 


The  jobnames  of  any  disconnected  jobs  are  listed 
at  login  time. 

/attj  $0860_0488_aap_8075 


AUXPRINT  (DTRC)  Print  a  file  on  your  auxiliary  printer  (the  one 
attached  to  your  terminal. 

Syntax:  AUXPRINT  -or- 

AUXP 

F  or  FILE=f ile 


STATUS=status  variable 

Parameters:  F  -  the  file  to  be  printed 

See  also:  PRINT_FILE 

Similar  commands:  NOS:  BEGIN, AUXPRNT 

VMS:  AUXPRINT 

Examples:  /AUXPRINT  my_file 


BACKUP_PERMANENT_FILES 

Begin  a  utility  session  to  back  up  permanent  files  and 
catalogs . 

Syntax:  BACKUP_PERMANENT_FILES  -or- 

BACKUP_PERMANENT_FILE  -or- 
BACPF 

BF  or  BACKUP  FILE=file 


L  or  LIST=file 

STATUS=s tatus  variable 

Subcommand  prompt:  PUB/ 

Similar  commands:  NOS:  RECLAIM;  CATLIST 

VMS:  BACKUP 


BASIC 

Compile  a  BASIC  source 

program. 

Syntax:  BASIC 

I 

or 

INPUT=f ile 

B 

or 

BINARY=f ile 

L 

or 

LIST=f i 1 e 

L0 

or 

LIST  OPTIONS® 1 i st  of  keyword 

AD 

or 

ARRAY  DIMENS IONS=keyword 

ISM 

or 

INPUT_SOURCE_MAP=f i 1 e 
STATUS=status  variable 
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Parameters:  LO 


list  options 
lo  meaning 


S  source  list 

0  object  code  list 

R  cross-reference  list 
N  none 
(default:  S) 


AD  -  specify  dimensioning  for  arrays 
ab  ad  meaning 

S  STATIC  fixed  when  compiled 

D  DYNAMIC  dimensions  can  be  changed 

(default:  STATIC) 


Similar  commands:  NOS,  VMS:  BASIC 


Examples:  /basic 

/basic  ad=d  lo=sr  l=$local ,b_lis 

A —  list  source  and  cross-reference 
in  file  $LOCAL.B_LIS;  use 
dynamic  storage  allocation 


BLOCK  Group  a  sequence  of  statements  into  a  block. 

Syntax:  label:  BLOCK 

statement  list 
BLOCKEND  label 


Parameters:  label  -  the  name  of  the  block 

(can  be  used  in  EXIT  statements  within 
the  block) 

Similar  commands:  VMS:  DECK...EOD 

Examples:  blkOl:  BLOCK 

•  •  • 

EXIT  blkOl  WHEN  NOT  status .normal 


BLOCKEND  blkOl 
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CANCEL  Cancel  the  most  recently  selected  conditions. 

Synt-;::  CANCEL  condition  names 

Parameters:  condition  names  -  the  conditions  to  be  cancelled 

(separate  multiple  condition 
names  with  comma  or  space) 
ANY_FAULT 
C0MMAND_EXIT 
EXIT 

LIMIT_FAULT 
PR0GRAM_FAULT 
PAUSE  (INTERRUPT) 

Non-selected  conditions  are  ignored. 

/cancel  ce  pf 


Remarks : 
Examples : 


CAUSE  Cause  a  condition  to  occur. 

Syntax:  CAUSE  status  expression 

Parameters:  status  expression  -  the  condition  to  be  caused  — 

must  be  of  type  STATUS 
(this  defines  OSV$STATUS) 

Remarks:  If  there  is  a  condition  handler  for  this 

condition,  it  is  activated. 


CHANGE_1 70_REQUEST 

Change  the  170  (NOS)  tape  file  description  in  a  temporary 
NOS/VE  file  formed  in  a  preceding  CREATE_170_REQUEST  command. 

Syntax:  CHANGE_170_REQUEST 

CHAIR 

F  or  FILE=file 


FSP  or  FILE_SET_POSITION=keyword 

FI  or  FILE_IDENTIFIER=s tring 

FSN  or  FI LE_SEQUENCE_NUMBER= integer 

GN  or  GENERATION_NUMBER=integer 

IC  or  INTERNAL_CODE=keyword 

CC  or  CHARACTER_CONVERSION=boolean 

BT  or  BLOCK_TYPE=keyword 

RT  or  RECORD_TYPE=keyword 

MBL  or  MAXIMUM_BLOCK_LENGTH= integer 

MRL  or  MAXIMUM_RECORD  LENGTH=integer 

TF  or  TAPE_FORflAT=keyword 

STATUS=status  variable 
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CHANGE_BACKUP_LABEL_TYPE 

Change  the  job  default  label  type  for  backup  to  tape. 

Syntax:  CHANGE_BACKUP_LABEL_TYPE  -or- 

CHABLT 

FLT  or  FILE_LABEL_TYPE=keyword 


STATUS=status  variable 

Parameters:  FLT  -  U  or  UNLABELLED 

L  or  LABELLED 


CHANGE_CATALOG_CONTENTS 

Delete  damage  condition  notices  from  files  in  the  specified 
catalog  and  all  its  subcatalogs,  and  delete  catalog  entries 
for  files  with  no  cycle  data. 

Syntax:  CHANGE_CATALOG_CONTENTS  -or- 

CHANGE_CATALOG_CONTENT  or 
CHACC 

C  or  CATALOG=keyword  or  file 


DDC  or  DELETE_DAMAGE_CONDITION  or 

DELETE_DAMAGE_CONDITIONS=list  of 

keyword 

DUR  or  DELETE_UNREC0N0NC I LEDF I LES  or 

DLC  or  DELETE_LOST_CYCLES=boolean 
STATUS=status  variable 

Parameters:  C  -  the  catalog  to  be  changed 

ALL  -  your  master  catalog 

DDC  -  the  damage  condition  to  be  deleted 
ab  option 

Mil  MEDIA_IMAGE_INCONSISTENT 
PCR  PARENT_CATALOG_RESTORED 
RMM  RESPF_MODIFICATION_MISMATCH 

DUF  -  delete  catalog  entries  for  all  files 
residing  on  a  missing  or  unavailable 
volume 

(default:  FALSE) 

Remarks:  DDC  or  DUF  is  required. 


Examples 


/chacc  Suser.catl 
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CHANGE_CATALOG_ENTRY 

Change  a  file's  catalog  entry  item(s). 

Syntax:  CHANGE_CATALOG_ENTRY  -or- 

CHACE 

F  or  FILE=f ile 


PW  or  PASSWORD=keyword  or  name 

NFN  or  NEW_F I LE_NAME=name 

NC  or  NEW_CYCLE=integer 

NPW  or  NEW_PASSWORD=keyword  or  name 

NL  or  NEW_LOG=boolean 

NR  or  NEW  RETENTION=integer 

NAP  or  NEW~ACCOUNT_PRO JECT=boo 1 ean 

DDC  or  DELETE_DAMAGE_C0NDITI0N=1 ist  of 

keyword 

STATUS=status  variable 

Similar  commands:  COS:  ALTACN;  MODIFY 

NOS:  CHANGE 

VMS:  RENAME;  SET  PROTECTION 

Examples:  /chace  old_name ,nfn=new_name 

A —  change  name  of  file  from 
OLD  NAME  to  NEW  NAME 


CHANGE_COMMAND_SEARCH_MODE 

Change  the  command  list  search  mode. 

Syntax:  CHANGE_COMMAND_SEARCH_MODE  ~or~ 

CHACSM 

SM  or  SEAT.CH_MODE=keyword 


STATUS=status  variable 

Parameters:  SM  -  G  or  GLOBAL 

R  or  RESTRICTED 
E  or  EXCLUSIVE 


Similar  commands:  NOS:  LIBRARY 
Examples:  /chasm, g 
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CHANGE_CONNECT ION_ATTR I BUTES 

Change  the  terminal  file's  connection  attributes. 

Syntax:  CHANGE_CONNECTION_ATTRIBUTES  -or- 

CHANGE_CONNECTION_ATTRIBUTE  -or- 
CHACA  -or- 

CHANGE_TERM_CONN_ATTRIBUTE  -or- 
CHANGE_TERM_CONN_ATTRIBUTES  -or- 
CHATCA 

TFN  or  TERMINAL  FILE  NAME=file 


AC  or  ATTENTION_CHARACTER=s tr ing 
BKA  or  BREAK_KEY_ACTION= integer 
EOI  or  END_OF_INFORMATION=string 
IBS  or  INPUT_BLOCK_SIZE= integer 
I EM  or  INPUT_EDITING_MODE=keyword 
IOM  or  INPUT_OUTPUT_MODE=keyword 
IT  or  INPUT_TIMEOUT=boolean 
ITL  or  INPUT_TIMEOUT_LENGTH= integer 
ITP  or  INPUT_TIMEOUT_PURGE=boolean 
PCF  or  PARTIAL_CHARACTER_FORWARDING=boolean 
PF  or  PROMPT_FILE=f ile 
PS  or  PROMPT_STRING=str ing 
SBC  or  STORE_BACKSPACE_CHARACETR=boolean 
SND  or  STORE_NULS_DELS=boolean 
TCM  or  TRANSPARENT_CHARACTER_MODE=keyword 
TFC  or  TRANSPARENT_FORWARD_CHARACTER= 
list  of  string 

TLM  or  TRAN S P ARENT_LENGTH_MODE=  keyword 
TML  or  TRANSPARENT_MESSAGE_LENGTH= integer 
TPM  or  TRANSPARENT_PROTOCOL_MORE=keyword 
TTC  or  TRANSPARENT_TERMINATE_CHARACTER= 
list  of  string 

TTM  or  TRANSPARENT_TIMEOUT_MODE=keyword 
STATUS=s tatus  variable 


Parameters:  TFN  -  the  terminal  file  name 

Similar  commands:  NOS:  TRMDEF 

VMS:  SET  TERMINAL 


CHANGE_FILE_ATTRIBUTES 

Change  an  existing  file's  attributes. 

Syntax:  CHANGE_FILE_ATTRIBUTES  -or~ 

CHANGE_F I LE_ATTR I BUTE  -or- 

CHAFA 

F  or  FILE=f i le 


FAPN  or  FILE_ACCESS_PROCEDURE_NAME= 

FAP  or  FILE_ACCESS_PROCEDURE= 
keyword  or  name 
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Similar 


FC 

or 

FL 

or 

FP 

or 

FS 

or 

FW 

or 

LN 

or 

LF 

or 

LET 

or 

LO 

or 

LR 

or 

RL 

or 

RA 

or 

SI 

or 

UI 

or 

commands:  NOS: 


FILE_CONTENTS= 
FILE_CONTENT=keyword 
FILE_LIMIT= integer 
FILE_PROCESSOR=keyword  or  name 
FILE_STRUCTURE=keyword  or  name 
FORCED_WRITE=keyword  or  boolean 
LINE_NUMBER=record 
LOADING_FACTOR= integer 
LOCK_EXPIRATION_TIME=int eger 
LOGG I N G_0P T IONS  or 
L0GGING_0PTI0N=1 ist  of  keyword 
LOG_RESIDENCE=keyword  or  file 
RECORD_LIMIT= integer 
RING_ATTRIBUTES=list  of  integer 
STATEMENT_IDENTIFIER=record 
USER_INFORMATION=str ing 
STATUS=status  variable 

FILE 


CHANGE_INPUT_ATTRIBUTE 

Change  an  input  job's  attributes  —  resubmit  a  job. 

Syntax:  CHANGE_INPUT_ATTRIBUTE  -or- 

CHANGE_INPUT_ATTRIBUTE  -or- 
CHAIA 

N  or  NAME  or  NAMES=list  of  name 


CB  or  C0MMENT_B ANNER=  string 

C  or  COPIES=integer 

CTL  or  CPU_TIME_LIMIT=keyword  or  integer 

D  or  DEVICE=keyword  or  name 

EPT  or  EARLIEST_PRINT_TIME=keyword  or 

date_time 

ERT  or  EARLIEST_RUN_TIME=keyword  or 

date_time 

EC  or  EXTERNAL_CHARACTERISTICS=keyword  or 

name 

FC  or  FORMS_CODE=keyword  or  string 
JAD  or  J0B_AB0RT_DISP0S I TI0N= keyword 
JC  or  JOB_CLASS=name 

JDBO  or  JOB_DEFERRED_BY_OPERATOR=boolean 
JDBU  or  JOB_DEFERRED_BY_USER=boolean 
JQ  or  JOB_QUALIFIER=keyword  or  list  of  name 
JRD  or  JOB_RECOVERY_DISPOSITION=keyword 
LPT  or  LATEST_PRINT_TIME=keyword  or 

date_t ime 

LRT  or  LATEST_RUN_TIME=keyword  or  date_time 
LA  or  LOGIN_ACCOUNT=keyword  or  name 
LP  or  LOGIN_PROJECT=keyword  or  name 
MTL  or  MAGNETIC_TAPE_LIMIT=keyword  or  integer 

MWS  or  MAXIMUM_WORKING_SET=keyword  or  integer 
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Examples : 


OF  or  OPERATOR_FAMILY=narae 

OU  or  OPERATOR_USER=name 

OC  or  OUTPUT_CLASS=keyword 

ODBU  or  OUTPUT_DEFERRED_BY  USER=boolean 

ODE  or  OUTPUT JOESTINATION=’name  or  string 

ODU  or  OUTPUT_DESTINATION_USAGE=keyword  or 

name 

ODI  or  OUTPUT_DISPOSITION=keyword  or  file 
OP  or  OUTPUT_PRIORITY=keyword 
PD  or  PURGE_DELAY=keyword  or  time_increment 
RHD  or  REMOTE_HOST_DIRECTIVE=s tr ing 
RB  or  ROUT ING_BANNER=st ring 
SI  or  SITE_INFORMATION=string 
SL  or  SRU_LIMIT=keyword  or  integer 
S  or  STATION=keyword  or  name 
UI  or  USER_INFORMATION=s tr ing 
UJN  or  USER_JOB_NAME=name 
VPD  or  VERTICAL_PRINT_DENSITY=keyword 
VLP  or  VFU_LOAD_PROCEDURE=keyword  or  name 
STATUS=status  variable 

/chaia  myjob  c-2  sl=200 

A —  change  copies  and  SRU  limit  and 
resubmit 


CHANGE_INTERACTION_STYLE 

Change  from  line  mode  to  screen  mode  or  vice  versa. 

Syntax:  CHANGE_INTERACTION_STYLE  -or- 

CHAIS 

S  or  STYLE=keyword 

MR  or  MENU_ROW  or  MENU_ROWS=integer 

EUI  or  ENTEND  UTILITY  INTERACTION=bool ean 


STATUS=s tatus  variable 

Parameters:  S  -  the  desired  mode 

LINE 

SCREEN 

MR  -  (attribute:  BY_NAME) 

the  number  of  rows  of  function  keys  that 
full-screen  applications  should  display 
mr  meaning 


0  do  not  display  function  keys 

1  display  one  row  of  function  keys 

2  display  two  rows 

(not  all  full-screen  applications  use  this) 
(default:  1) 
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EUI  -  (attribute:  BY_NA“E) 

control  whether  a  default  screen  interface 
screen  is  to  be  used  with  utilities  which 
do  not  have  one 
(default:  FALSE) 

Remarks:  When  you  log  in,  interactive  prompting  is 

disabled.  CHAIS  enables  it. 

SCL  function:  $INTERACTION_STYLE  -  obtain  current  setting 
Similar  commands:  NOS:  LINE;  SCREEN 
Examples:  /chais  mr=0 


CHANGE_JOB_ATTR I BUTE 

Change  the  current  job's  attributes. 


Syntax : 


CHANGE_ JOB_ATTR I BUTE  -or~ 
CHANGE  JOB  ATTRIBUTES  ~or~ 


CHAJA 

CB 

or 

C 

or 

CAI 

or 

DJWT 

or 

D 

or 

DP 

or 

EPT 

or 

EC 

or 

FC 

or 

JAD 

or 

JRD 

or 

LPT 

or 

MAXWS 

or 

MINWS 

or 

OF 

or 

OU 

or 

OC 

or 

ODBU 

or 

ODE 

or 

ODU 

or 

ODI 

or 

OP 

or 

PAI 

or 

integer 


integer 


date  time 


name 


date_time 

IT=keyword 

integer 

iT=keyword 

integer 


name 
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PD 

or 

PURGE  DELAY'keyword  or  time  increment 

RHD 

or 

REMOTE_HOST_DIRECTIVE=string 

RB 

or 

ROUTING_BANNER=s tr ing 

SI 

or 

SITE_INF0RMATI0N=string 

S 

or 

STATION=keyword  or  name 

UI 

or 

USER  INFORMATION'S t ring 

UJN 

or 

USER  J OB_NAME=name 

VPD 

or 

VERTICAL_PRINT_DENSITY=keyword 

VLP 

or 

VFU_L0AD_PR0CEDURE=keyword  or  name 
STATUS'S tatus  variable 

Similar  commands:  NOS:  SETJOB 

imples:  /chaja  "new  banner"  10 

A —  new  banner  and  10  copies  (the 
maximum) 


CHANGE_JOB_LIMIT 

Change  a  job's  resource  limits. 

Syntax:  CHANGE_JOB_LIMIT  ~or- 

CHAJL 

N  or  NAME=keyword  or  name 
WL  or  WARNING_LIMIT  or  RESOURCE_LIMIT  or 
RL'keyword  or  integer 


STATUS=status  variable 

Parameters:  N  -  the  resource  to  be  changed 

name  meaning 

CPU_TIME  cpu  time  limit 

SRU  system  resource  unit  limit 

TASK  system  task  resource  limit 

WL  -  a  new  value  for  the  limit  (an  integer  or 
UMLIMITED) 

SCL  function:  $J0B_LIMIT  -  obtain  the  job's  resource  limits 
See  also:  DISPLAY_JOB_LIMIT 

Similar  commands:  NOS:  SETASL;  SETJSL;  SETTL 
Examples:  /chaja  cpu_time  60 
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CHANGE_LINK_ATTRIBUTES 

Change  individual  link  attributes  for  communication  between 
dual-state  partners  (NOS/VE  and  NOS). 


Syntax:  CHANGE_L INK_ATTR I BUTES  -or- 

CHANGE_L INK_ATTR I BUTE  -or~ 

CHALA 

F  or  FAMILY=name  or  string 
U  or  USER=name  or  string 
PW  or  PASSWORD=name  or  string 
C  or  CHARGE  or  ACCOUNT  or  A=name  or  string 
P  or  PRO JECT=name  or  string 


STATUS=s tatus  variable 


Examples:  /chala  pw=mymsspw 

A —  you  may  wish  to  put  this  into 
your  PROLOG  file 


CHANGE_LOG I N_P ASS WORD 

Set  or  change  your  login/batch  password. 


Syntax:  CHANGE_LOGIN_PASSWORD  ~or- 

CHALP  -or- 

SET_PASSWORD  ~or~ 

SETPW 

OPW  or  OLD_PASSWORD  or  FROM  or  F=name 
NPW  or  NEW  PASSWORD  or  TO  or  T=name 


ED  or  EXPIRATION_DATE=keyword  or  date_time 
El  or  EXPIRATION_INTERVAL=keyword  or  integer 
STATUS=status  variable 


Parameters:  ED 


the  date  and  time  your  password  will  expire 


El  -  the  number  of  days  until  your  password 
expires 


Remarks : 


If  ED  and  El  are  omitted,  your  expiration  interval 
is  used. 


If  ED  and  El  are  specified,  ED  is  used,  but  your 
expiration  interval  is  changed. 


Similar  commands:  COS:  ACCOUNT, NUPW= ;  CSUBMIT/NUPW  (on 

VAXcluster) 

NOS:  PASSWOR 
VMS:  SET  PASSWORD 


Examples : 


/setpw  old  new 
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CHANGE_MESSAGE_LEVEL 

Select  the  NOS/VE  message  display  format. 

Syntax:  CHANGE_MESSAGE_LEVEL  -or- 

CHAML  -or- 

SET_MESSAGE_LEVEL  -or- 

SETML 

L  or  LEVEL  or  INFORMATION_LEVEL  or 
IL=keyword 


STATUS=status  variable 

Parameters:  L  -  the  desired  format 

BRIEF  -  severity  level  and  message  text 
(file  references  are  in  current 
working  catalog) 

FULL  -  BRIEF  plus  product  identifier, 
condition  code 

(file  references  include  full  path) 
Similar  commands:  VMS:  SET  MESSAGE 
Examples:  /chaml  brief 


CHANGE_OUTPUT_ATTRIBUTE 

Change  an  output  file's  attributes. 

Syntax:  CHANGE_OUTPUT_ATTRIBUTE  ~or~ 

CHANGE_OUTPUT_ATTRIBUTES  -or- 
CHAOA 

N  or  NAME=list  of  name 


CB  or  COMMENT_BANNER=string 

C  or  COPIES=integer 

D  or  DEVICE=keyword  or  name 
EPT  or  EARLIEST_PRINT_TIME=keyword  or 

date_time 

EC  or  EXTERNAL_CHARACTERISTICS=keyword  or 

name 

FC  or  FORMS_CODE=keyword  or  string 
LPT  or  LATEST_PRINT_TIME=keyword  or 

date_t ime 

OF  or  OPERATOR_FAMILY=name 

OU  or  OPERATOR_USER=name 

OC  or  OUTPUT_CLASS=keyword 

ODBO  or  OUTPUT_DEFERRED_BY_OPERATOR=boolean 

ODBU  or  OUTPUT_DEFERRED_BY_USER=boolean 

ODE  or  OUTPUT_DESTINATION=name  or  string 

ODU  or  OUTPUT_DESTINATION_USAGE=keyword  or 

name 

OP  or  OUTPUT_PRIORITY=keyword 

PD  or  PURGE_DELAY=keyword  or  t ime_increment 

RHD  or  REMOTE_HOST_DIRECTIVE=s tr ing 
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Examples : 


RD 

or 

REPRINT  DISPOSITION=keyword 

RB 

or 

ROUTING  BANNER=str ing 

SI 

or 

SITE_INFORMATION=string 

S 

or 

STATION=keyword  or  name 

UI 

or 

USER  INFORMAT I 0N=st ring 

VPD 

or 

VERTICAL_PRINT_DENSITY=keyword 

VLP 

or 

VFU_LOAD_PROCEDURE=keyword  or  : 
STATUS=s tatus  variable 

/ chaoa 

myjob  "new  banner" 

CHANGE_SCL_OPTION 

Change  the  options  provided  by  the  SCL  interpreter. 


Syntax:  CHANGE_SCL_OPTION  -or- 

CHANGE_SCL_OPTIONS  -or- 
CHASCLO  -or- 

CHASO 


LSCP  or  LINE_STYLE_CORRECTION_PROMPTS=keyword 
SSCP  or  SCREEN_STYLE_CORRECTION_PROMPTS=keyword 
NFL  or  NAME_FOLDING_LEVEL=keyword 
WCPT  or  WILD_CARD_PATTERN_TYPE=keyword 
STATUS=status  variable 

Parameters:  (attribute  (all  parameters):  BY_NAME) 

LSCP  -  controls  prompting  for  corrections  to 
parameters  entered  in  line  mode 
lscp  meaning 


LINE  prompted  in  line  mode 
SCREEN  prompted  in  screen  mode 
NONE  no  prompting  —  the  command  must 
be  reentered 
(initial  value:  LINE) 

SSCP  -  controls  prompting  for  corrections  to 
parameters  entered  in  screen  mode 
sscp  meaning 


SCREEN  prompted  in  screen  mode 
NONE  no  prompting  —  the  command  must 
be  reentered 
(initial  value:  SCREEN) 
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NFL  -  controls  the  interpretation  of  SCL  names 
(file,  variable  and  parameter  names,  and 
names  used  within  the  Source  Code  and 
Object  Code  Utilities) 

STANDARD_FOLDING  -  upper  and  lower  case 

letters  are  equivalent 
FULL_F0LDING  -  STANDARD_FOLDING  plus 

lower  upper 

@  C 

t  { 

\  ! 

]  } 

A  ^ 

Initial  value:  STANDARD_FOLDING 

WCPT  -  the  wild  card  pattern  that  can  be  used  to 
match  catalog  or  file  paths;  lists  of 
names,  program  names,  or  sttings 
ab  option  meaning 

B  BASIC  *,  ?,  and  '  plus  $ALL 

E  EXTENDED  B  plus  wild  card  classes 

(requires  NFL=STANDARD_ 
FOLDING;  if  NFL=FULL_ 
FOLDING,  []  around  character 
classes  are  treated  as  0) 
(initial  value:  EXTENDED) 

SCL  function:  $WILD_CAF  FILES 

$SELECT_W A  lD_CARD_NAMES 

$SELECT_WILD_CARD_PROGRAM_NAMES 

$SELECT_WILD_CARD_STRINGS 

Examples:  /chaso  wcpt=b 

A —  accept  only  basic  wildcards 


CHANGE_TAPE_LABEL_ATTRIBUTES 

Change  the  current  magnetic  tape  label  attributes. 

Syntax:  CHANGE_TAPE_LABEL_ATTRIBUTES  ~or- 

CHANGE_TAPE_LABEL_ATTRIBUTE  ~or~ 
CHATLA 

F  or  FILE=f i 1 e 


BT 

or 

BLOCK  TYPE=keyword 

CC 

or 

CHARACTER  C0NVERSI0N=bool ean 

CS 

or 

CHARACTER_SET=keyword 

CD 

or 

CREATION  DATE=date 

ED 

or 

EXP I RAT 1 0N_DATE=da  t  e 

FAC 

or 

FILE  ACCESSIBILITY_CODE=str ing 

FI 

or 

FILE  IDENTIFIER=s tr ing 

FSN 

or 

FILE  SEQUENCE  NUMBER=integer 
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FSI 

or 

FILE_SET  IDENTIFIER'S tring 

FSP 

or 

FILE_SET  POSITION'keyword 

GN 

or 

GENERATION  NUMBER'integer 

GVN 

or 

GENERATION  VERSION  NUMBER'integer 

MAXBL 

or 

MAXIMUM  BL0CK_LENGTH= integer 

MAXRL 

or 

MAXIMUM_RECORD_LENGTH=integer 

PC 

or 

PADDING  CHARACTER'S tring 

RT 

or 

RECORD_TYPE=keyword 

RL 

or 

REWRITE  LABELS'boolean 

STATUS'S tatus  variable 


See  also:  DISPLAY_TAPE_LABEL_ATTRIBUTES 

Similar  commands:  NOS:  LABEL 

Examples:  /reqmt  f i le=$l ocal . tapel  type=mt9$6250  .. 

.. /extv=  '  taped  '  recv=  '  taped  '  ring=true 
/chatla  £i le=$local . tapel  rewri te_labels=true 
/copy_file  filel  $local. tapel 
/detach_file  $local. tapel 


CHANGE_TERMINAL_ATTRIBUTES 

Define  and  change  an  interactive  terminal's  attributes. 

or- 
or- 
or- 
or- 
or- 


AC  or  ATTENTION_CHARACTER=s tring 

BC  or  BACKSPACE_CHARACTER=s t ring 

BLC  or  BEGIN_LINE_CHARACTER=s tring 

CLC  or  CANCEL_LINE_CHARACTER=s tring 

CRD  or  CARR I AGE_RETURN_DELAY= integer 

CRS  or  CARR I AGE_RETURN_SEQUENCE=  string 

CFC  or  CHARACTER_FLOW_CONTROL=boolean 

CS  or  CODE_SET=keyword  or  name 

CCR  or  CONTROL_CODE_REPLACEMENT=keyword  or 

list  of  record 

E  or  ECHOPLEX=boolean 

ELC  or  END_LINE_CHARACTER=s tring 

ELP  or  END_LINE_POSITIONING=keyword 

EOS  or  END_OUTPUT_SEQUENCE=  string 

EPA  or  END_PAGE_ACTION=keyword 

EPC  or  END_PAGE_CHARACTER=s tring 

EPP  or  END_PARTIAL_POSITIONING=keyword 

FL  or  F0LD_LINE=bool ean 

FFD  or  FORM_FEED_DELAY= integer 

FFS  or  FORM_FEED_SEQUENCE=s  t ring 


Syntax:  CHANGE_TERMINAL_ATTRIBUTES  - 

CHANGE_TERM1NAL_ATTR I BUTE 
CHATA 

SET_TERMINAL_ATTRIBUTES 

SET_TERMINAL_ATTRIBUTE 

SETTA 
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FKC 

or 

HP 

or 

HPO 

or 

LFD 

or 

LFS 

or 

NCC 

or 

PL 

or 

PW 

or 

P 

or 

PSC 

or 

SA 

or 

TC 

or 

TM 

or 

TBC 

or 

FUNCTION_KEY_CLASS=keyword  or  name 
HOLD_PAGE=boolean 
HOLD_PAGE_OVER=boolean 
LINE_FEED_DELAY= integer 
LINE_FEED_SEQUENCE=str ing 
NETWORK_COMAND_CHARACTER=s t  r i ng 
PAGE_LENGTH= int eger 
PAGE_WIDTH= integer 
PAR I TY= keyword 

PAUSE_BREAK_CHARACTER=s tring 
STATUS_ACTION=keyword 
TERMINAL_CLASS=name 
TERMINAL_MODEL=keyword  or  name 
TERMINATE_BREAK_CHARACTER=s tring 
STATUS=s tatus  variable 


Parameters:  E  -  controls  whether  input  characters  are  echoed 
back  to  the  terminal 

PL  -  the  number  of  lines  displayed  an  output  page 
0  -  continuous 


PW  -  the  number  of  characters  displayed  in  a  line 
*  0  -  infinite  (the  network  does  no  line 

folding) 

P  -  parity 

EVEN,  ODD,  MARK,  NONE,  ZERO 

Similar  commands:  NOS:  TRMDEF 

VMS:  SET  TERMINAL 

Examples:  /chata  pl=23 


CHANGE_TERM_CONN_DEFAULTS 

Change  a  terminal's  default  connection  atttributes. 


CHANGE_UNSEEN_MAIL_ACTION 

Specify  whether  your  are  to  receive  notification  of  new  mail 
while  your  job  is  running. 

Syntax:  CHANGE_UNSEEN_MA I L_AC  T I ON  -or- 

CHAUMA 


A  or  ACTION=keyword 

STATUS'S tatus  variable 

Parameters:  A  -  how  to  respond  to  new  mail 

ab  option  meaning 


D  DISPLAY  immediate  notification 

P  POST  post  the  message  until  you 

change  to  DISPLAY 
(default  at  DTRC:  DISPLAY) 


Page  H-28 


RevO 


90/09/30 


Examples:  /chauma  p 

A —  hold  new  mail  messages  while 
running  a  program  so  any  such 
message  won't  interrupt  the 
program 

/exet  myprog 
/ chauma  d 

A —  restore  display  mode 


CHANGE_UTI L I T Y_ATTR I BUTES 

Change  the  attributes  of  a  utility  command  (UTILITY/ 
UTILITYEND) . 

Syntax:  CHANGE_UTILITY_ATTRIBUTES  -or- 

CHANGE_UTILITY_ATTRIBUTE  -or- 
CHAUA 

U  or  UTILITY=name 


ESL  or  ENABLE_SUBCOMMAND_LOGGING=boolean 
IIP  or  INTERACTIVE_INCLUDE_PROCESSOR=keyword 

or  name 

LP  or  LINE_PROPROCESSOR=keyword  or  name 
OM  or  ONLINE_MANUAL=keyword  or  name 
P  or  PROMPT=string 
T  or  TABLES=file 

STATUS=status  variable 

Parameters:  (attribute:  BY_NAME  (all  except  U)) 

SCL  function:  $UTILITY 


CHANGE_WORKING_CATALOG 

Establish  the  default  working  catalog. 

Syntax:  CHANGE_WORKING_CATALOG  -or- 

CHAWC  ~or_ 

SET_WORKING_CATALOG  ~or~ 

SETWC 

C  or  CATAL0G=file 


STATUS=status  variable 

Parameters:  C  -  the  catalog  to  be  the  working  catalog  — 
one  of: 

.  a  specific  catalog 
.  $ LOCAL 

.  $USER  (the  master  catalog) 

SCL  function:  $WORKING_CATALOG 
See  also:  DISPLAY  WORKING  CATALOG 


Similar  commands:  VMS:  SET  DEFAULT 
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Examples:  /chawc  $user 

/chawc  $user .mycat_l 

/disv  $working_catal og  -or-  disv  $wc 
:NVE. AMDS 
/ 


CHECKFORMAIL 

Check  for  unread  mail. 

Syntax:  CHECK_FOR_MAIL  -or- 

CHEFM 


STATUS=status  variable 

Remarks:  CHEFM  executes  outside  of  Mail/VE. 

MVV$HAVE_MAIL  is  set  to  TRUE  if  you  have  mail. 

See  also:  ANY_MAIL  (DTRC) 

Similar  commands:  VMS:  MAIL 

Examples •  /CHEFM 

/if  mvv$have_mai 1  then 

if/email 

if /if end 


COBOL  Compile  a  COBOL  source  program. 


Syntax: 


COBOL 


I 

or 

B 

or 

L 

or 

LO 

or 

AUD 

or 

BL 

or 

DA 

or 

DD 

or 

E 

or 

EL 

or 

El 

or 

FIPS 

or 

ISM 

or 

LBZ 

or 

LC 

or 

OL 

or 

RC 

or 

SD 

or 

SP 

or 

INPUT=f ile 

BINARY=f ile 
LIST=f ile 

LIST_OPTIONS=l ist  of  keyword 

A  or  AUDIT=boolean 

BASE_LANGUAGE=keyword 

DEBUG_AIDS=list  of  keyword 

DUMP_DATA=boolean 

ERR0R=f ile 

ERROR_LEVEL=keyword 

EXTERNAL_INPUT  or  EX_INPUT=f i le 

FED_INF0_PR0CESSING_STANDARD=1 ist  of 

keyword 

INPUT_SOURCE_MAP= f i 1 e 
LEADTNG_BLANK_ZERO=boolean 
LITERAL_CHARACTER=s tr ing 
OPTIMIZATION_LEVEL  or  OPTIMIZATION  or 
OPT=keyword 

RUNTIME_CHECKS=1 ist  of  keyword 
STANDARDS_DIAGN0STICS=1 ist  of  keyword 
SUBPROGRAM=bool ean 
STATUS=s tatus  variable 
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Parameters : 


LO  -  one  or  more  of  the  following: 

lo  meaning 


NONE  none  of  the  options 

M  data-  and  procedure-name  map 

0  object  code  listing 

(do  not  use  unless  requested  by 
User  Services) 

R  cross-reference  list  of  all  data- 

and  procedure-names  referenced  in 
program 

RA  cross-reference  list  of  all  data- 

and  procedure-names 
S  source  program  list 

SA  like  S,  but  include  lines  turned 

off  by  NOLIST 
(default:  S) 

BL  -  specify  the  variety  of  COBOL  being  used 
bl  meaning 


ANS74  1974  ANSI  COBOL  Standard 

ANS85  1985  ANSI  COBOL  Standard 

C0B0L5  written  for  compilation  by  COBOL5 
(default:  ANS85) 

DA  -  one  or  more  of  the  following: 


da 

meaning 

NONE 

none  of  the  options 

ALL 

all  except  SY 

DS 

compile  source  debugging 
(D  in  column  7) 

1  ines 

DT 

put  line  number,  symbol. 

and 

source  map  loader  tables 
object  code 

into 

OC 

produce  object  code  even 
errors 

if  source 

SY 

syntax  check  -  no  object 

code 

TR 

flow  trace 

(default:  NONE) 

T  and 

I  are  the  same 

El  -  SCU  library  file  for  COPY  statements 
$NULL  -  do  not  use  an  SCU  library 
(default:  do  not  use  an  SCU  library) 
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ISM  -  the  file  with  the  source  map  generated  by 
SCU  EXPAND_DECK  OUTPUT_SOURCE_MAP 
(default:  the  compiler  constructs  the  file) 

LBZ  -  TRUE  -  treat  leading  blanks  in  numeric 

fields  as  zeros  in  arithmetic  and 
comparisons 

(default:  blanks  in  numeric  fields  are 
an  error) 

LC  -  change  the  non-numeric  literal  delimiter 
character 

lc  meaning 


""  apostrophe 
""  quotation  mark 
(default:  "") 

OL  -  controls  optimization 

option  meaning 


LOW  production  quality  code 
DEBUG  stylized  for  debugging 
(default:  LOW) 

SD  -  diagnose  non-ANSI  code  (ignored  if  BL  <> 
ANS85) 

sd  meaning 


NONE  do  not  select  any 

option 

(severity, ANSI)  assign  a  severity  to 
non-ANSI  errors 
severity  is  I,  W,  or  F 

(default:  NONE) 

SP  -  specify  whether  the  source  is  a  main  or 
subprogram 

sp  meaning 


TRUE  subprogram 
FALSE  main  program 
(default:  FALSE) 

Similar  commands:  NOS:  C0B0L5 

VMS:  COBOL 

/cobol  i=my_cob_source  b=my_cob_lgo 
. ./lo=(s,r,m)  l=my_cob_l ist 


Examples : 
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COLLECT 


COMMAND 


TEXT 

Copy  lines  of  text  from  the  command  list  to  a  specified  file. 

Syntax:  COLLECT_TEXT  -or~ 

COLT 

0  or  OUTPUT® fi le 


U  or  UNTIL=string  literal 
P  or  PROMPT=string 

SM  or  SUBSTITUTION_MARK=keyword  or  string 
I  or  INPUT=f i le 

STATUS=status  variable 

Parameters:  U  -  the  string  terminating  the  text  —  is  not 
copied 

(default:  '**') 

P  -  the  prompt  if  input  is  from  the  terminal 
(first  character  is  format  effector 
(carriage  control)  -  use  space  to  put 
prompt  on  a  new  line) 

' '  -  (null  string)  no  prompt 
(default:  '  ct?') 

Subcommand  prompt:  ct? 

Similar  commands:  NOS:  COPY;  .DATA*,  NOTE 

VMS:  CREATE 

Examples:  /colt, data 

ct?Run  1  on  90/06/29 
ct?  1  4  7 

ct?26. 3  17.9e4  23 

ct?** 

/ 


Declare  an  entry  in  utility  command  table. 

Syntax:  COMMAND 

N  or  NAME  or  NAMES=list  of  name 

P  or  PR0CESS0R=name 
A  or  AVAILABILITY® keyword 
AL  or  AUTOMAT I CALL Y_L0G=boo lean 
STATUS=s tatus  variable 
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COMPARE_FILE 

A  binary  comparison  of  two  files. 

Syntax:  C0MPARE_FILE  ~or~ 

COMPARE_FILES  -or~ 
COMF 

F  or  FILE=f i le 
W  or  WITH=f ile 


EL  or  ERROR_LIMTT=integer 

0  or  0UTPUT=f ile 

STATUS=status  variable 

Similar  commands:  COS:  COMPARE 

NOS:  VERIFY 
VMS:  DIFFERENCES 

Examples:  /comf  myprog.3  myprog.2 

A —  compare  two  versions  of  a  file 

COMP ARE_OB  JECT_L I BRAR Y 

Compare  two  object  libraries  or  two  object  files. 

Syntax:  C0MPARE_0B JECT_LIBRARY  -or- 

COMOL 

F  or  FILE-file 
W  or  WITH=f i le 


0  or  OUTPUT=f ile 

STATUS=status  variable 

See  also:  CREATE_OBJECT_LIBRARY;  DISPLAY_OBJECT_LIBRARY; 

DISPLAY_0B JECT_TEXT 

Similar  commands:  NOS:  VFYLIB 

Examples:  /comol  libl  lib2 


COMPRESS_MAI L_DAT ABASE 

Create  a  new  copy  of  your  mailbox  file  (MVF$ELECTRONIC_MAIL 
DATABASE)  in  your  master  catalog,  with  unused  space  removed 
and  any  data  faults  corrected. 

Syntax:  COMPRESS_MAI L_DAT ABASE  -or- 

COMMD 


STATUS=status  variable 


Remarks : 


This  command  reclaims  deleted  space. 
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It  also  allows  you  access  to  Mail/VE  after  any 
system  interrupt  occurring  while  mail  is  sent  or 
received  by  repairing  any  damage  done  by  the 
interrupt . 

See  also:  EMAIL 

Similar  commands:  VMS:  MAIL>  COMPRESS 

Examples:  /commd 


CONTINUE  Exit  the  current  WHEN  statement. 

Syntax:  CONTINUE 

option 

WHEN  boolean  expression 

Parameters:  option  -  one  of  the  following: 

NEXT 

continue  with  statement  following  the 
one  that  activated  the  condition 
handler 
RETRY 

retry  with  statement  that  activated 
the  condition  handler 
(default:  NEXT) 

when  -  if  the  boolean  expression  is: 

TRUE  -  the  WHEN  block  is  exited 
FALSE  -  the  WHEN  block  is  not  exited  - 
processing  continues  with  the 
next  statement 

(default:  the  block  is  exited) 


CONVERT_UPDATE_TO_SCU 

Convert  an  UPDATE  source  library  to  SCU  format. 

Syntax:  CONVERT_UPDATE_TO_SCU  -or- 

CONUTS 


OPL 

or 

OLD  PROGRAM  LIBRARY=f ile 

R 

or 

RESULT=f i 1 e 

L 

or 

LIST=f i 1 e 

NL 

or 

NAME  LIST=f ile 

DO 

or 

DISPLAY  0PTI0NS=keyword 

CS 

or 

CODE_SET=keyword 

SC 

or 

SELECTION_CRITERIA=f ile 
STATUS=s tatus  variable 

Parameters:  OPL  -  UPDATE  library  file 

(default:  OLDPL) 
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R  -  SCU  library  file 

(default:  SOURCE_LIBRARY  in  your  working 
catalog) 

NL  -  the  substitution  file 

(default:  no  names  are  replaced) 

DO  -  controls  L  output  -  one  of: 

B  or  BRIEF  -  brief  listing 
F  or  FULL  -  full  listing  including  the 
changed  lines 
(default:  BRIEF) 

CS  -  the  UPDATE  library  file  code  set  -  one  of: 
ASCII64  -  64-character  set 

(6-bit  display  code) 

ASCII128  -  128-character  set 
(8/12  ASCII  code) 

(default:  ASCII128) 

SC  ~  the  criteria  fileconvert  DEFINE  directives 
from  the  YANK$$$  deck  to  selection  criteria 
commands  and  write  to  a  file 
(default:  no  selectioon  criteria  commands 
are  written) 

Remarks:  The  UPDATE  library  must  be  sequential. 

Examples:  /conuts  nl=new_names  cs=ascii64  .. 

. . /sc=oldpl_criterion 


COPY_FILE 

Copy  a  file. 

Syntax:  C0PY_FILE  -or- 

COPF 


I  or  INPUT=f i 1 e 
0  or  OUTFUT=f ile 

STATUS=status  variable 

Remarks:  Data  is  copied  from  the  open  position  until 

end-of-information  (EOl)  (disk  files)  or  a  tape 
mark  (magnetic  tape) . 

Error  conditions: 

I  empty  -  abnormal  status 

I  at  EOI  -  FSE$INPUT_FILE_AT_EOI 

I  at  double  tape  mark  -  AME$INPUT_AFTER_EOI 

For  multi-file,  unlabeled  ta^  ,  use  one  COPY_FILE 
for  each  file. 
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Single  tape  marks  are  not  copied. 

The  output  file  inherits  the  input  file's  cycle 
attributes  (except  the  ring  attributes)  unless 
SET_FILE_ATTRIBUTES  has  been  issued  for  the  output 
file. 

The  output  file's  structure  may  differ  from  the 
input  file's. 

Similar  commands:  COS:  COPYD 

NOS:  COPY;  COPYEI;  REPLACE;  SAVE 
VMS:  COPY 

Examples:  /copy_file  input=$user .myf ile  output=$local .mf 

/copf  Suser.myfile 

A —  copy  file  to  SOUTPUT 
/copf  $user .myf i lei . $boi  $user.myfile2.$eoi 
A—  append  MYFILE1  to  MYFILE2 


CREATE_1 70_REQUEST 

Create  a  NOS/VE  temporary  file  to  be  associated  with  a  170 
(NOS)  tape  file. 

Syntax:  CREATE_170_REQUEST  -or- 

CRE1R 

F  or  FILE=file 


EV  or  EXTERNAL_VSN= list  of  string 
RV  or  RECORDED_VSN= list  of  string 
FSP  or  FILE_SET_POSITION=keyword 
FI  or  FILE_IDENTIFIER=s tring 
FSN  or  FI LE_SEQUENCE_NUMBER= integer 
GN  or  GENERATION_NUMBER= integer 
IC  or  INTERNAL_CODE=keyword 
CC  or  CHARACTER_CONVERSION=boolean 
BT  or  BL0CK_TYPE= keyword 
RT  or  RECORD_TYPE=keyword 

MBL  or  MAXBL  or  MAXIMUM_BLOCK_LENGTH= integer 
MRL  or  MAXIMUM_RECORD_LENGTH= integer 
LT  or  LABEL_TYPE=keyword 
TF  or  TAPE_FORMAT=keyword 

STATUS=status  variable 

Parameters:  F  -  the  name  of  the  NOS/VE  temporary  file 

associated  with  a  VAX  tape  file  by  a 
previous  CREATE_VAX_REQUEST . 

EV  -  external  identification/sticker 
(each  is  1-6  characters) 

(default:  EV=RV) 
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RV  -  internal  VSN  (each  is  1~6  characters) 

(ignored  for  unlabeled  tapes  unless  EV  is 
omitted  -  in  which  case,  EV=RV) 

FSP  -  the  position  of  the  VAX  tape  file  to  be 


read 

ab 

f  sp 

file  to  be  read 

BOS 

BEGINNING  OF  SET 

first  tape  file 

CF 

CURRENT  FILE 

the  current  file 

FIP 

FILE  IDENTIFIER 
POSITION 

file  identified  by 
the  FILE  IDENTIFIER 
and  GENERATION_ 
NUMBER  parameters 

FSP 

FILE  SEQUENCE 
POSITION 

file  identified  by 
the  F I LE_SEQUENCE_ 
NUMBER  parameter 

NF 

NEXT  FILE 

the  next  file 

(default:  NF) 

FI  -  the  1-  to  17-character  file  label 
(ignored  if  FSP  <>  FIP) 

FSN  -  file  number  on  a  multi-file  tape 
(range:  1-9999) 

(ignored  if  FSP  <>  FSN) 

GN  -  the  specific  revision  number  of  the  FI  file 
(range:  1-9999) 

(ignored  if  FSP  <>  FIP) 

(default:  1) 

IC  -  the  character  set  of  the  data  on  the  tape 


1C 

meaning 

AS6 

6/12-bit  ASCII 

AS8 

8/12-bit  ASCII 

D63 

63-character  display 

code 

D64 

64-character  display 

code 

(default:  D64) 

controls  character  conversion 

cc 

meaning 

TRUE 

convert  from  <internal  c 

FALSE 

do  not  convert 

(default:  FALSE) 

BT  -  the  block  type  of  the  tape  file 

ab  bt  blocking 


I  INTERNAL  internal 

CC  CHARACTER_COUNT  character  count 
(default:  INTERNAL) 
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RT  -  the  record  type  of  the  tape  file 


abbrev 

rt 

meaning 

W,  CW 

CONTROL  WORD 

control  word 

F,  FL 

FIXED  LENGTH 

fixed  length 

S,  SR 

SYSTEM  RECORD 

system  record 

Z,  ZB 

ZERO  BYTE 

zero  byte 

(default 

:  CONTROL  WORD) 

MBL  -  maximum  length  in  6-bit  bytes  of  a  block  on 
the  170  tape  file 
(maximum:  2,147,483,615) 

(default:  5120) 

MRL  -  maximum  length  in  6~bit  bytes  of  a  record 
on  the  170  tape  file 
(maximum:  4,398,046,511,103) 

(default:  5120) 

LT  -  specifies  whether  the  tape  is  labeled 
ab  It  meaning 


L  LABELLED  same  as  STANDARD 

S  STANDARD  tape  has  standard  labels 

U  UNLABELLED  tape  is  unlabelled 

(default:  STANDARD) 

TF  -  the  format  the  tape 


abbrev 

tf 

meaning 

I,  NI 

NOS_INTERNAL 

INTERNAL,  NOS 
default 

NBI ,  SI 

NOS_BE_INTERNAL 

SCOPE  interna 
NOS/BE  defaul* 

S 

STRANGER 

stranger 

L,  LS 

LONG  STRANGER 

long  stranger 

(default : 

NOS  INTERNAL) 

See  also:  CHANGE_170_REQUEST 

Similar  commands:  NOS:  LABEL 

Examples:  Associate  temporary  file  FILE_FTN  with  a  typical 

Fortran  formatted  tape  file  (BT=CC,  RT=ZB) : 

/create_170_reques t  f i le=f i le_f tn  .. 

. . /external_vsn= 'NA9876 '  .. 

. . /f i le_set_pos i tion=file_identi f ier_pos i t ion  . . 
. . /f i le_ident i f i er= ' RUN  123'  .. 

. . /internal_code=as6  .. 

.  . /character_convers i on=true  .. 

.  . /block_type=character_count  .. 
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../record  type=zero_byte  .. 

. ./mbl=4000  .. 

. . /mr 1=200  .  . 

.  ./label_type=labelled  .. 

.  . /tape_f ormat=nos_internal 

A —  standard  labeled  tape  NA9876 
with  ASCII  6/12-bit  data,  file 
"RUN  123",  blocked  200  by  20 


CREATE_CATALOG 

Create  a  new  catalog. 

Syntax:  CREATE_CATALOG  -or- 

CREC 

C  or  CATALOG=file 

STATUS=status  variable 

Parameters:  C  -  the  new  catalog  to  be  created 

Remarks:  An  empty  catalog  is  created. 

Only  the  master  catalog  owner  can  create  a  new 
catalog. 

Similar  commands:  VMS:  CREATE/DIRECTORY 
Examples:  /crec  rm 


CREATE_CATALOG_PERM I T 

Grant  or  deny  permission  to  use  a  catalog. 

Syntax:  CREATE_CATAL0G_PERMIT  -or- 


CRECP 

C 

or 

CATAL0G=f ile 

G 

or 

GR0UP=k eywor d 

FM 

or 

FAMILY  NAME=name 

U 

or 

USER=name 

A 

or 

ACCOUNT=name 

P 

or 

PROJECT=name 

AM 

or 

ACCESS_MODE  or  ACCESS_MODES=list  of 

keyword 

SM 

or 

SHARE  M0DES=list  of  keyword 

AI 

or 

APPLICATION_INFORMATION=string 
STATUS=status  variable 
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Parameters:  C  -  the  new  catalog  to  be  created 

G  ~  controls  whether  the  permit  entry  is  for  one 
user  or  a  group  of  users 

PUBLIC  -  all  users 

FAMILY  -  all  users  in  family 

ACCOUNT  -  all  users  in  family  and 

account 

PROJECT  -  all  users  in  family,  account 

and  project 

USER  -  the  user  in  family 

USER_ACCOUNT  -  the  user  in  family  and 
account 

MEMBER  -  the  user  in  family,  account 

and  project 

(default:  USER) 

FM  -  the  family  name 

(default:  the  requesting  job's  family) 

U  -  the  specific  user 

(default:  the  requesting  job's  user  name) 

A  -  the  account 

(default:  the  requesting  job's  account) 

P  -  the  project 

(default:  the  requesting  job's  project) 

AM  -  how  the  user(s)  may  access  the  file 


mode 

meaning 

READ 

read  access  is  granted 

APPEND 

data  may  be  added  at  the  end  of 
the  file 

MODIFY 

data  may  be  altered 

EXECUTE 

object  code  or  SCL  procedures  may 
be  executed 

SHORTEN 

data  may  be  deleted  from  the  end 
of  the  file 

WRITE 

SHORTEN,  MODIFY  and  APPEND 

ALL 

READ,  APPEND,  MODIFY,  EXECUTE, 
SHORTEN,  and  WRITE 

CONTROL 

delete  files  and  change  file 
identifications  and/or  attributes 

CYCLE 

add  new  cycles  and  create  initial 
cycles 

NONE 

access  is  prohibited 

(default : 

READ  and  EXECUTE) 

SM  -  how  all  files  in  the  catalog  must  be  shared 
(same  as  AM,  except  CONTROL,  CYCLE,  NONE) 
(default:  same  as  AM,  except  APPEND,  SHORTEN, 
MODIFY,  or  WRITE  forces  NONE; 
otherwise:  READ  and  EXECUTE) 
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AI  -  up  to  31  characters  for  use  by  application 
programs  for  additional  access  controls 
(default:  a  string  of  spaces) 

Remarks:  If  an  access  control  entry  already  exists  for  the 

user  or  group,  then  AM,  SM,  and  AI  are  replaced. 

See  also:  DISPLAY_CATALOG  D0= 

Examples:  /creep  rm  g=public  am=read 

A —  allow  everyone  to  read  catalog  RM 


CREATE_COMMAND_LIST_ENTRY 

Add  entries  to  the  beginning  of  end  of  the  command  list. 

Syntax:  CREATE_COMMAND_LIST  ENTRY  ~or~ 

CREATE_COMMAND_L I S  T~EN  TR I ES  -or- 
CRECLE 

E  or  ENTRIES  or  ENTRY=list  of:  keyword  or 

file 


P  or  PLACEMENT=keyword 

STATUS=status  variable 

Parameters:  E  -  the  entries  to  be  added  to  the  command  list 

SSYSTEM  -  the  SSYSTEM  command  library  is 
added 

P  -  controls  where  the  entries  are  added 

A  or  AFTER  -  added  after  the  current  entries 
B  or  BEFORE  -  added  before  the  current 
entries 

(default:  BEFORE) 

Remarks:  Cannot  be  used  when  the  command  list  search  mode 

is  EXCLUSIVE. 

If  the  search  mode  is  RESTRICTED,  only  P=A  is 
allowed. 

Similar  commands:  COS,  NOS:  LIBRARY 

Examples:  /crecle  my_procs 

A —  add  object  library  MY_PR0CS 
containing  my  procedures 
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CREATE_DEFAULT_VARIABLE 

Create  an  environment  variable  to  be  used  as  a  default. 


Syntax:  CREATE_DEFAULT_VARIABLE  -or- 

CREDV 

N  or  NAME=data_name 
D  or  DEFAULT=string 


S  or  SCOPE=keyword 

STATUS=status  variable 

Parameters:  N  -  the  name  of  the  default  variable 


D  -  the  value 

(when  the  variable  name  is  used  as  a  default, 
this  value  becomes  the  default  value) 

S  -  ENVIRONMENT,  JOB,  TASK,  UTILITY 
(default:  JOB) 

Examples:  /credv  osc$disci_display_option  .. 

, ./ 'parameterdescription' 

/ 


CREATE_FILE 

Create  a  new  file  (or  cycle  of  a  file)  and  attach  it  to  the 
j  ob. 

Syntax:  CREATE_FILE  -or~ 

CREF 

F  or  FILE=f i le 


LFN  or  LOCAL_FILE_NAME=name 
PW  or  PASSWORD=keyword  or  name 
R  or  RETENTION=integer 
L  or  LOG=boolean 

STATUS'S tatus  variable 

Parameters:  F  -  (default  cycle:  SNEXT) 

R  -  the  number  of  days  the  file  is  to  be  retained 
(range:  1-999;  default:  999) 

L  -  controls  whether  a  log  of  file  activity  is  to 
be  kept 

(default:  FALSE) 

This  command  is  not  normally  used  to  create  a 
file.  It  is  needed  if 

.  the  file  needs  password  protection,  attachment 
logging,  or  an  expiration  date 


Remarks : 
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.  subsequent  commands  require  a  local  file  name 
for  reference 

.  a  local  file  name  is  needed  to  ensure  that  the 
file  cycle  is  consistently  referenced 

See  also:  ATTACH_FILE;  DETACH_FILE 

Similar  commands:  NOS:  DEFINE;  SAVE 

VMS:  CREATE  (no  local  file  concept) 

Examples:  /cref  $user.data_l  pw=mypw  l=true 


CREATE_F I LE_CONNECT I ON 

Create  a  connection  between  two  files  so  that  any  data  access 
request  against  the  subject  file  is  passed  to  the  target  file. 


Syntax:  CREATE_FI LE_CONNECT ION  -or- 

CREFC 

SF  or  STANDARD_F I LE=  file 
F  or  FILE=f ile 


STATUS=status  variable 

Parameters:  SF  -  one  of  the  following: 

SECHO,  $ERR0RS,  $INPUT,  $LIST,  $OUTPUT, 
SRESPONSE,  any  other  local  file 

F  -  the  target  file  to  be  connected  to  the 
subject  file. 

Remarks:  A  subject  file  may  be  connected  to  more  than  one 

target  file. 

Input:  access  requests  are  passed  to  the  most 
recently  connected  target  file. 

Output:  access  requests  are  passed  to  all 
connected  files. 


See  also:  DELETE_FI LE_CONNECTI ON ;  DISPLAY_FILE_CONNECTIONS 

Similar  commands:  COS:  ASSIGN 

NOS:  ASSIGN;  FILE 
VMS:  ASSIGN;  DEFINE 

Examples:  /crefc  Secho  echo_file 

A —  echo  commands  to  file  ECHO  FILE 


/crefc  sf=$output  f=my_out_f i le 

A —  write  batch  output  into  file 
MY  OUT  FILE 
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crefc  $local.tape5  $local. input 

A —  program  reading  from  Fortran  unit 
5  will  read  from  keyboard  —  you 
must  be  in  your  $LOCAL  catalog 


CREATE_F I LE_PERM I T 

Establish  or  modify  an  access  control  entry  for  a  file. 
Syntax:  CREATE_FILE_PERMIT  -or- 


CREFP 

F 

or 

FILE=f ile 

G 

or 

GROUP=keyword 

FM 

or 

FAMILY  NAME=name 

U 

or 

USER'name 

A 

or 

ACC0UNT=name 

P 

or 

PROJECT=name 

AM 

or 

ACCESS_MODE  or  ACCESS_M0DES=1 ist  of 

keyword 

SM 

or 

SHARE  MODES' list  of  keyword 

AI 

or 

APPLICATION_INFORMATION=s  tr ing 
STATUS'status  variable 

Parameters:  same  as  CREATE_CATALOG_PERMIT,  except  they 

apply  to  the  specified  file 

Similar  commands:  NOS:  CHANGE;  PERMIT 

VMS:  EDIT/ACL;  SET  FILE 

Examples:  /crefp  myfile  g=public  am=execute 

A —  allow  anyone  to  execute  file 
MY  FILE 


CREATE_FILE_VARIABLE 

Create  an  environment  variable  of  type  FILE. 

Syntax:  CREATE_FILE_VARIABLE  -or- 

CREFV 

N  or  NAME=date_name 
F  or  FILE=f i le 


S  or  SCOPE=keyword 

STATUS=s tatus  variable 

Parameters:  N  -  the  name  of  the  file  variable 

F  -  the  value  of  the  variable 
(must  be  of  type  FILE) 

S  -  ENVIRONMENT,  JOB,  TASK,  UTILITY 
(default:  JOB) 

A  file  variable  is  useful  when  referring  to  files 
or  catalogs  that  are  not  in  your  working  catalog. 


Remarks : 
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Similar  commands:  VMS:  ASSIGN;  DEFINE 

Examples:  /create_f ile_variable  n=john_doe 

. . /f= . xxxx . reports 
/display_catal og  john_doe 
FILE:  DAILY_REPORTS 
FILE:  WEEKLY_REPORTS 
FILE:  MONTHLY  REPORTS 


CREATE_INTERSTATE_CONNECTION 

Establish  a  NOS  batch  control  point  on  a  dual-state  system. 

Syntax:  CREATE_INTERSTATE_CONNECTION  -or- 

CREIC 


PJC  or  PARTNER_JOB_CARD=s tring 
STATUS=status  variable 

Parameters:  PJC  -  the  job  statement  parameters  for  the  NOS 

job 

Remarks:  After  CREIC,  you  are  prompted  (FA/)  until  you 

enter  QUIT  or  DELETE_INTERSTATE_CONNECTION. 

While  the  connection  is  open,  you  may  enter 
.  any  NOS/VE  command  (except  this  command) 

.  any  NOS  command  (executed  using  EXECUTE_ 
INTERSTATE_COMMAND) 

Subcommand  prompt:  FA/ 

See  also:  DELETE_INTERSTATE_CONNECTION ;  EXECUTE_INTERSTATE 

COMMAND 

/creic  pjc='myjob, ,64. ' 

FA/exeic  c= ' at tach , oldf i 1 e . ' 

FA/exeic  c= ' define , newfi le . ' 

FA/exeic  c= ' copy , oldf i le , newfi le . ' 


Examples : 
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CREATE_MANUAL 

Read  a  source  file  of  directives  and  text  to  create  an  on-line 
manual  for  use  by  EXPLAIN  or  HELP. 


Syntax:  CREATE_MANUAL  -or- 

CREM 

I  or  INPUT=file 
0  or  OUTPUT=f i le 


E  or  ERROR=f ile 

L  or  LIST=f ile 

LO  or  LIST_OPTIONS=keyword 

STATUS=status  variable 

Parameters:  0  -  output  bound  file  with  the  finished  manual 

(default:  $ LOCAL. MANUAL) 

E  -  error  message  file 

(default:  SLOCAL. ERRORS  (the  terminal)) 

L  -  if  LO=R,  cross-reference  listing  of  screen 
names  and  indexed  subjects 
(default:  $LIST) 


LO  -  controls  the  contents  of  the  LIST  file 


lo 

meaning 

R 

produce  the  listing 

NONE 

no  listing 

(def aul t 

:  NONE) 

Examples:  /crem  i=$user . ccrm_in  .. 

. . /o=Suser . ccrm 
. . /e=$user . ccrm_errors 
. . /l=$user . ccrm_cross_ref erence 
. . /lo=r 


CREATE_OBJECT_LIBRARY 

Begin  a  CREATE_0B JECT_LIBRARY  utility  session. 

Syntax:  CREATE_OB JECT_LIBRARY  -or- 

CREOL 

STATUS=status  variable 

See  also:  C0MPARE_0B JECT_LIBRARY ;  DISPLAY_0B JECT_LIBRARY ; 

DISPLAY_OB JECT_TEXT 

Subcommand  prompt:  COL/ 

See  also:  Sections  8~3,  8~4,  8-6 
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Similar  commands:  NOS:  LIBEDIT;  LIBGEN 

VMS:  LIBRARY 

Examples:  See  sections  8-3,  8~4,  8-6. 


CREATE_PROGRAM_PROF I LE 

Generate  a  program  profile. 


Syntax:  CREATE_PROGRAM_PROFILE  -or- 

CREPP 

TT  or  TARGET  TEXT=file 


F  or  FILES  or  FILE=list  of  file 
P  or  PARAMETER=string 

L  or  LIBRARIES  or  LIBRARY=list  of  file 

M  or  MODULES  or  MODULE* list  of  program_name 

SP  or  STARTING_PROCEDURE=program_name 

PO  or  PROFILE_ORDER=keyword 

PUC  or  PROGRAM_UNIT_CLASS=keyword 

N  or  NUMBER=keyword  or  integer 

0  or  OUTPUT=f i le 

STATUS=status  variable 

Parameters:  TT 

F  -  object  files  or  libraries  to  be  included 
(must  include  TT  file)  —  all  modules  are 
included 

(default:  TT  file) 


P  -  parameter  list  passed  to  the  program 

L  -  object  libraries  to  be  added  to  the  program 

library  list  —  only  those  modules  needed 
are  included  —  libraries  are  searched  in 
the  order  specified 

M  -  modules  to  be  loaded  from  the  program 
library  list  libraries 

SP  -  starting  entry  point  name 

(default:  last  transfer  point  encountered 
during  loading) 

PO  -  order  for  display  of  program  profile  output 
abb  po  meaning 


T  TIME  time  7.  from 

greatest  to 
least 

PU  PROGRAM_UNIT  alphabetically 

by  program  name 

MPU  M0DULE_PR0GRAM_UNIT  alphabetically 

by  module  name 


(default:  TIME) 
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PUC  -  controls  the  class  of  program  whose 
statistics  are  displayed 

puc  meaning 


ALL  local  and  remote  programs  units 

LOCAL  program  units  in  TT 

REMOTE  program  units  called  by  TT,  but 
not  in  TT 
(default:  ALL) 

N  -  number  of  program  unit  statistics  to  be 
displayed  —  the  statistics  are  sorted 
according  to  P0  and  displayed  until  N 
statistics  have  been  displayed 
(default:  the  entire  program  profile) 

Examples:  /crepp  lgo  o=prof ile_lgo 

A —  puts  the  profile  for  the  program 
in  LGO  into  file  PROFILE  LGO 


CREATE_TOP I CS_F I LE 

Create  a  Topics  manual  from  a  text  file  using  binding. 

Syntax:  CREA"E_TOPICS_FILE  -or- 

CRETF 

I  or  INPUT=f ile 
0  or  OUTPUT=file 


E  or  ERROR=f i le 

STATUS=s tatus  variable 

Parameters:  F  -  file  with  the  text  of  the  manual  including 

directives  defining  the  manual  title, 
headlines,  and  index  entries  (optional) 

See  also:  DISPLAY_TOPICS_FILE;  Section  8-8 

Examples:  See  section  8~8. 


CREATE_VAX_REQUEST 

Create  a  NOS/VE  temporary  file  to  be  associated  with  a  VAX 
tape  file  used  for  future  references  to  the  VAX  tape  file. 

Syntax:  CREATE_VAX_REQUEST  -or- 

CREVR 

F  or  FILE=f i le 


EVSN  or  VSN  or  EXTERNAL_VSN=1 ist  of  string 
RVSN  or  RECORDED_VSN=list  of  string 
FSP  or  FILE_SET_POSITION=keyword 
FI  or  FILE_IDENTIFIER=string 
FSN  or  F I LE_SEQUENCE_NUMBER= int cger 
GN  or  GENERATION_NUMBER= integer 
STATUS=status  variable 
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Parameters:  F  -  the  name  of  the  NOS/VE  temporary  file 

VSN  -  the  external  sticker  number  (1—6 

characters)  —  if  more  than  one,  they  are 
requested  in  the  order  specified 
(default:  RECORDED_VSN  is  used) 

RVSN  -  the  VSN  written  in  the  ANSI  VOL1  label 

(1-6  characters)  —  of  more  than  one,  they 
are  located  and  verified  in  the  order 
specified 

(default:  EXTERNAL_VSN  is  used) 

(note:  either  VSN  or  RVSN  must  be 
specified) 


FSP  -  the  position  of  the  file  in  a  set  of  files 
on  a  set  of  tape  volumes 
BOS  or  BEGINNING_OF_SET 
read  the  first  file  in  the  set 
CF  or  CURRENT_FILE 
the  last  file  accessed  is  rewritten 
FIP  or  FILE_IDENTIFIER_POSITION 
read  the  tape  file  identified  by  the  FI 
parameters  or  and  GN 
FSP  or  F I LE_SEQUENCE_POS 1 T I ON 
read  the  tape  file  identified  by  the  FSN 
parameter 
NF  or  NEXT_FILE 

read  or  write  the  file  after  the  last 
file  accessed 
(default:  NEXT_FILE) 

FI  -  file  label  (1-17  characters) 


FSN  -  the  numeric  position  of  the  file  on  a 

multifile  tape  —  required  if  FILE_SET_ 
POSITION  is  specified,  ignored  otherwise) 
(default:  last  file  accessed  +  1) 


GN  -  a  specific  version  of  the  tape  file  named 
in  the  FI  parmameter 
(range:  1-9999) 


Similar  commands:  NOS:  LABEL 


CYCLE  Execute  the  next  iteration,  if  any,  of  a  repetitive  command. 

Syntax:  CYCLE 

label 

WHEN  boolean  expression 
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Parameters:  label  -  a  label  associated  with  the  enclosing 

repetitive  statement  to  be  cycled 
(default:  the  innermode  repetitive 
statement  is  cycled) 

when  ~  if  the  boolean  expression  is: 

TRUE  -  cycling  takes  place 
FALSE  -  no  cycling 
(default:  no  cycling) 


DECRYPTFILE 

Decrypt  a  file  encrypted  using  ENCRYPT_FILE. 

Syntax:  DECRYPT_FILE  -or- 

DECF 

I  or  INPUT=f ile 
0  or  OUTPUT=f i le 

DK  or  DES_KEY=integer  or  string  or  name 


DM  or  DES_MODE=keyword 

DIV  or  DES_INITIAL_VECTOR=integer  or  string 

or  name 

RA  or  RESTORE_ATTRIBUTES=boolean 
STATUS=status  variable 

Parameters:  DK  -  (attribute:  SECURE) 

the  cryptographic  key 

type  requirement 


integer  each  byte  of  the  binary 

representation  of  the  integer 
must  have  odd  parity 
string  exactly  8  ASCII-128  characters 
name  a  valid  NOS/VE  name  with  exactly 
8  characters 

DM  -  (attribute:  SECURE) 

the  decryption  mode  to  be  use 

ab  option  and  meaning 


ECB  ELECTRON I C_C0DEB00K 

use  the  basic  Data  Encryption 
Standard  algorithm 
CBC  CIPHER_BLOCK_CHAINING 

use  the  cipher  block  chaining  mode 
of  operation 
CFB  CIPHER_FEEDBACK 

use  the  cipher  feedback  mode  of 
operation  (feedback  unit  data  length 
is  64  bits) 
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DEFINE 


DEFINE 


OFB  OUTPUT_FEEDBACK 

use  the  output  feedback  mode  of 
operation  (feedback  unit  data  length 
is  64  bits) 

(default:  ELECTRON I C_CODEBOOK) 

DIV  -  (attribute:  SECURE) 

define  a  seed  value  for  CBC,  CFB,  OFB 
(must  be  same  as  DIV  of  ENCRYPT_FILE; 
ignored  for  ECB) 

RA  -  TRUE  =>  NOS/VE  file  attributes  of  the 
input  file  are  restored  to  the 
decrypted  file  (they  must  have 
been  preserved  on  encryption) 

FALSE  =>  the  file  attributes  were  not 

preserved  or  are  to  be  ignored 
(the  length  of  the  input  file 
must  be  a  multiple  of  8  bytes) 


See  also:  ENCRYPT_FILE 

Similar  commands:  VMS:  ENCRYPT  (DTRC) 

Examples:  /decf  crypt_file  plain_file  ABCD1234 


PR IMARY_TASK 

Designate  the  requesting  task  as  the. primary  task  for  the  job. 

Syntax:  DEFINE_PRIMARY_TASK  -or~ 

DEFPT 


STATUS=s tatus  variable 


TERMINAL 

Compile  your  terminal  definition  file. 

Syntax:  DEFINE ^TERMINAL  -0r- 

DEFT 

I  or  INPUT=f i 1 e 


B  or  BINARY=file 
L  or  LIST=file 

STATUSES tatus  variable 

Parameters:  B  -  (default:  TERMINAL  DEFINITIONS) 
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DELETE_ALL__CYCLES 

(DTRC)  Delete  all  cycles  of  one  or  more  files, 


Syntax : 


DELETE_ALL_CYCLES  -or- 
DELAC 

F  or  FILE=1 ist  of  file 


STATUS=status  variable 

Parameters:  F  -  the  file  or  list  of  files  to  be  deleted 


Similar  commands:  COS:  DELETE 

NOS:  PURGE 

VMS:  DELETE;  PURGE 

Examples:  /DELETE_ALL_CYCLES  F=my_file 

/DELAC  (my_f i le_l ,my_f ile_2) 


DELETE_CATALOG 

Delete  a  catalog  and,  optionally,  its  contents, 


Syntax : 


DELETE_CATALOG  -or~ 
DELC 

C  or  CATALOG=file 


DO  or  DELETE_OPTION=keyword 
STATUS=status  variable 

Parameters:  DO  -  the  parts  of  the  catalog  to  be  deleted 

CAC  or  CATALOG_AND_CONTENTS 
CO  or  CONTENTS_ONLY 
OIE  or  ONLY_IF_EMPTY 

Remarks:  You  cannot  delete  your  master  catalog. 

Similar  commands:  VMS:  DELTREE  (DTRC) 

Examples:  /dele  catl  do=co 

A —  delete  contents  of  catalog  CATl 


DELETE_CATALOG_PERMIT 

Delete  an  access  control  entry  for  a  catalog. 


Syntax : 


DELETE_CATALOG_PERMIT  -or- 
DELCP 

C  or  CATALOG=file 


G  or  GROUP=keyword 
FM  or  FAMI LY_NAME=name 
U  or  USER=name 
A  or  ACCOUNT=name 
P  or  PROJECT=name 

STATUSES tatus  variable 
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Similar  commands:  VMS:  SET  PROTECTION 
Examples:  /delcp  catl 


DELETE_COMMAND_LIST_ENTRY 

Delete  entries  from  the  command  list. 

Syntax:  DELETE_COMMAND_LIST_ENTRY  -or- 

DELETE_COMMAND  LIST_ENTRIES  -or- 
DELCLE 

ENTRY~list  of:  keyword  or  file 


STATUS=s tatus  variable 

Parameters:  E  -  the  entries  to  be  deleted  from  the  command 
list 

SSYSTEM  -  the  SSYSTEM  command  library  is 
deleted  from  the  list 

Remarks:  Cannot  be  used  when  the  command  list  search  mode 

is  EXCLUSIVE. 

If  the  search  mode  is  RESTRICTED,  the  entry  at 
the  beginning  of  the  command  list  cannot  be 
deleted. 

Similar  commands:  COS,  NOS:  LIBRARY 
Examples:  /delcle  my_procs 


DELETE_FILE 

Delete  a  file  or  cycle  of  a  file. 

Syntax:  DELETE_FILE  -or- 

DELELE_FILES  ~or- 
DELF 

F  or  FILE=1 ist  of  file 


PW  or  PASSWORD=keyword  or  name 
STATUS=s tatus  variable 

Parameters:  F  -  (default  cycle:  SLOW) 

PW  -  (attribute:  SECURE) 

Remarks:  CONTROL  permission  is  required. 

Similar  commands:  COS,  VMS:  DELETE 

NOS:  PURGE 

Examples:  /delf  (a,  be,  d_e) 
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DELETE_F I LE_CONNECT I ON 

Delete  the  connection  between  files. 

Syntax:  DELETE_FILE_CONNECTION  -or- 

DELFC 

SF  or  STANDARD_FILE=file 
F  or  FILE=f ile 


STATUS=s tatus  variable 

Parameters:  SF  -  one  of  the  following: 

$ECHO,  $ERRORS ,  $INPUT,  $LIST,  $OUTPUT, 
$RESPONSE,  any  other  file 

F  -  the  target  file  to  be  disconnected  from  the 
subject  file. 

Remarks:  The  original  connection  for  $RESPONSE  cannot  be 

deleted. 

DELFC  lists  each  subject  file  and  its  target 
files. 

See  also:  CREATE_FILE_CONNECTION ;  DISPLAY_FILE_CONNECTIONS 

Similar  commands:  NOS:  FILE 

VMS:  DEASSIGN 

Examples:  /delfc  Secho  echo_file 

DELETE_FILE_PERMIT 

Delete  an  access  control  entry. 

Syntax:  DELETE_FILE_PERMIT  -or- 

DELFP 

F  or  FILE=f i 1 e 


G  or  GROUP=keyword 
FM  or  FAMILY_NAME=name 
U  or  USER=name 
A  or  ACCOUNT=name 
P  or  PROJECT=name 

STATUS=s tatus  variable 

Similar  commands:  NOS:  CHANGE;  PERMIT 

VMS:  EDIT/ACL;  SET  FILE 


Examples : 


/delfp  my_file  public 
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DELETE 


DELETE 


INTERSTATE_CONNECTION 

Terminate  the  interstate  connection. 

Syntax:  DELETE_INTERSTATE_CONNECTION  -or- 

DELIC 
QUIT 
QUI 


STATUS=s tatus  variable 

See  also:  CREATE_INTERSTATE_CONNECTION ;  EXECUTE_INTERSTATE 

COMMAND 

Examples:  /creic  pjc='myjob, ,64. ' 

FA/exeic  c=’NOS  command’ 

FA/delic 


VARIABLE 

Delete  variables  accessible  from  the  current  block. 

Syntax:  DELETE_VARIABLE  ~or- 

DELETE_VARIABLES  -or- 
DELV 

N  or  NAME  or  NAMES=data_name  or 
list  of  data  name 


STATUS=status  variable 

Parameters:  N  -  the  variable(s)  to  be  deleted 

Similar  commands:  VMS:  DEASSIGN;  DELETE/SYMBOL 

Examples:  /delete_variables  (abc,def) 

A —  delete  variables  ABC  and  DEF 


PROCEDURE  sample 
VAR 

gl?bal_abc:  (TOB)  integer  =  0 
errors:  boolean  =  FALSE 
VAREND 

IF  errors  THEN 

delv  global_abc 
delv  global_abc 
I  FEND 
PROCEND 

A —  GLOBAL_ABC  is  deleted  twice  — 
if  a  block  creates  a  variable 
with  a  scope  wider  than  the  block 
itself,  an  additional  access  is 
established  in  that  block  —  the 
first  DELV  deletes  the  proce¬ 
dure’s  access,  the  second  deletes 
the  variable  from  the  job  block 
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DESIGN_SCREEN 

Enter  the  Screen  Design  Facility  (SDF) . 

Syntax:  DESIGN_SCREEN  -or- 

DESIGN_SCREENS  -or- 
DESS 


L  or  LIBRARY=f ile 
M  or  MODE=keyword 
SK  or  SCREEN_MODE=name 
S  or  SOURCE=f ile 

UID= application 
UPW=application 
DL  or  DM_LIBRARY=f i le 
DS  or  DM_S0URCE=  file 

STATUS=status  variable 

Similar  commands:  NOS:  screen  management 

VMS :  FMS 


DETACH_FILE 

Detach  one  or  more  files  from  a  job. 

Syntax:  DETACH_FILE  -or- 

DETACH_FILES  -or- 
DETF 

F  or  FILE  or  FILES=list  of  file 


STATUS=status  variable 

Remarks:  Files  to  be  detached  must  be  closed. 

Standard  files  (e.g.,  $LIST)  in  $LOCAL  cannot  be 
detached. 

An  error  causes  any  remaining  files  in  the  list 
to  remain  unprocessed. 

See  also:  ATTACH_FILE;  CREATE_FILE 

Similar  commands:  COS:  RELEASE 

NOS:  RETURN 

VMS:  no  local  file  concept 

Examples:  /detach_file  file=myfile 

/detf  f i 1 es= (myf i 1  el ,myf i le2) 


/reqmt  f i le=$local . tapel  type=mt9$6250  .. 

. . /extv= ' tapeOl '  recv= ' tapeOl '  ring=true 
/chatla  file=$local , tapel  rewrite_labels=true 
/copy_file  filel  Slocal. tapel 
/detach_file  Slocal. tapel 
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DETACH_JOB 

Explicitly  disconnect  your  terminal  from  the  current  job. 


Syntax:  DETACH_JOB  -or- 

DETJ 


STATUS=status  variable 

Remarks:  (ncc)D  will  do  this  at  any  time  ((ncc)  is  your 

network  command  character) . 

Examples:  /detj  -or-  %D 


DI S  P  LA Y_AC T I V  E_TASKS 

Display  tasks  executing  within  the  current  job. 

Syntax:  DISPLAY_ACTIVE_TASKS  -or- 

DISAT 


0  or  OUTPUT=f ile 

5TATUS=s tatus  variable 

Remarks:  (ncc) A  will  do  this  at  any  time  ((ncc)  is  your 

network  command  character) . 

Similar  commands:  VMS:  SHOW  SYSTEM;  SHOW  USERS  /FULL 

Examples:  /disat  out 

A —  put  display  into  file  OUT 


DISPLAY_BACKUP_LABEL_TAPE 

Display  the  current  job  default  label  type  for  a  permanent 
file  backup  file  on  tape. 

Syntax:  DISPLAY_BACKUP_LABEL_TAPE  -or- 

DISBLT 


0  or  OUTPUT=f i le 

STATUS=status  variable 


DISPLAY_CATALOG 

Audit  files  and  catalogs  in  a  specific  catalog  or  about  the 
access  control  list  at  the  catalog  level. 

Syntax:  DISPLAY_CATALOG  -or- 

DISC 


C  or  CATALOG=file 

DO  or  DISPLAY_OPTIONS=keyword 

0  or  0UTPUT=f  ile 

D  or  DEPTH=keyword  or  integer 

I EC  or  INCLUDE_EXCEPTION_CONDITIONS=keyword 
STATUS=status  variable 


Page  H-58 


RevO 


90/09/30 


Parameters:  C  -  (default:  current  working  catalog) 


type 

ab 

of  display: 
option 

meaning 

ID 

IDENTIFIER 

display  file  or  catalog 

I 

name  and  type  (file  or 

catalog) 

F 

FILE 

display  a  summary 

description  of  the  files 


P  PERMIT  display  access  control 

PERMITS  entries 

C  CONTENT  display: 

CONTENTS  .  disk  space  occupied 

(bytes) 

.  file  size  (bytes) 

.  damage  condition 
(if  IEC  specified) 
(default:  IDENTIFIER) 

D  -  amount  of  information  to  be  displayed 
d  meaning 


1  1-line  summaiy  of  the  catalog 

2  files  and  subcatalogs 

3  2  +  files  in  each  subcatalog 
ALL  ail  subcatalogs  and  files 

(default:  2) 

IEC  -  (attribute:  BY_NAME) 

display  conditions  which  pre^'c'e  attaching 
the  cycle 

iec  meaning 


ALL  display  conditions 

(requires:  D0=C  and  (D=3  or  D=ALL) 
NONE  do  not  display  conditions 
(default:  NONE) 

Similar  commands:  COS:  AUDIT;  DS 

NOS:  CATLIST;  ENQUIRE, F 
VMS:  DIRECTORY 

Examples:  /display_catalog  Suser 

A —  display  files  in  master  catalog 
CATALOG:  mycat_l 
FILE:  EPILOG 
FILE:  myfile_l 
FILE:  PROLOG 
/disc  $local 

A —  display  local  files 

A —  display  files  in  current  working 
catalog 


/disc 
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I 


/disc  $user  do=permits 

A —  display  access  control  list  for 
master  catalog 


DISPLAY_CATALOG_ENTRY 

Audit  a  file,  its  usage,  or  its  access  control  list. 

Syntax:  DISPLAY_CATaLOG_ENTRY  -or~ 

DISCE 

F  or  FILE=f ile 


DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=keyword 
0  or  OUTPUT* f ile 

D  or  DEPTH=keyword  or  integer 

I EC  or  INCLUDE_EXCEPTION_CONDIT IONS* keyword 
STATUS=status  variable 

Parameters:  DO  -  type  of  display: 

ab  option  meaning 


display  file  usage 
information 

display  access  control 
entries 

display  descriptive 
information  about  the 
file  and  file  cycles 
display: 

.  disk  space  occupied 
(bytes) 

.  damage  condition 
(if  IEC  specified) 
(default:  DESCRIPTOR) 

D  -  amount  of  information  to  be  displayed 
d  meaning 

1  1-lxne  summary  of  the  file 

2  each  cycle  of  the  file 
ALL  all  cycles  of  the  file 

(default:  2) 

IEC  -  (attribute:  BY_NAME) 

display  conditions  which  preclude  attaching 
the  cycle 

iec  meaning 


L 

P 

D 


LOG 

PERMIT 

PERMITS 

DESCRIPTOR 


CYCLES 


» 


ALL  display  conditions 
(requires  DO=C) 

NONE  do  not  display  conditions 
(default:  NONE) 
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Similar  commands:  COS:  AUDIT 

NOS:  CATLIST 
VMS:  DIRECTORY 

Examples:  /display_catalog_entry  Suser.myfile  do=log 

A —  displays  date  and  time,  family, 
user,  access  count,  last  cycle 
/disce  Suser.myfile  do=descriptor 

A —  displays  number  of  cycles, 
account,  project,  password, 
log  selection,  cycle  number, 
access  count,  creation  date/time, 
last  access  date/time,  mast 
modification  date/time, 
expiration  date 
/disce  Suser.myfile  do=cycles 

A--  displays  size  of  each  cycle  and 
damage  condition,  if  any,  e.g., 
myfile  0  bytes  in  cycle  88 

cycle  88  —  respf  modification  mismatch 


DISPLAY_COMMAND_ INFORMAT ION 

Display  information  about  a  command. 

Syntax:  DISPLAY_COMMAND_INFORMATION  -or- 

DISCI  -or- 

DISPLAY_COMMAND_PARAMETER  -or- 

DISPLAY_COMMAND_PARAMETERS  *or- 
DISCP 

C  or  COMMAND=command  reference 


0  or  OUTPUT=f ile 

DO  or  DISPLAY_OPTIONS=1 ist  of  keyword 
STATUS=status  variable 

Parameters:  C  -  the  name  of  the  command 

DO  -  the  type  of  information  to  display 
ab  option  meaning 


AN 

S 

BH 

FH 

CPD 


ALL_NAMES 

ALL_NAME 

SOURCE 

BR IEF_HELP 
FULL  HELP 


all  of  the  command's  names 
including  aliases 
the  command  list  entry 
that  contains  the  comnand 
brief  help  message 
full  help  message 
(if  no  full,  brief  is 
displayed) 


COMPACT_PARAMETER_DESCRIPTION 

COMPACT_PARAMETER_DESCRIPTIONS 

information  from  the 
parameter  description  table 
(PDT)  in  compact  format- 
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PD  PARAMETER_DESCR I PT I ON 

PARAMETER_DESCRIPTIONS 

information  from  the 
parameter  description  table 
(PDT)  in  expanded,  easy-to- 
read  format 
PH  PARAMETER_HELP 

parameter  help  messages 
AU  ADVANCED  USAGE 

information  about 
parameters  with  ADVANCED 
or  ADVANCED_KEY  attribute 
HMS  HELP_MODULE_SEED 

the  seed  name  for  the  help 
module  associated  with  the 
command 

ALL  all  available  information 

about  the  command 
(default:  AN,BH,CPD) 

Remarks:  SCL  system  variable  OSD$DISCI_DISPLAY_OPTIONS 

has  the  default  display  options. 

Similar  commands:  COS:  CRAY>  HELP;  Cint>  HELP  (both  on 

VAXcluster) 

NOS:  HELPME;  HELP  /LIBR=VSYS:NOS  (on 
VAXcluster) 

VMS:  HELP 

Examples:  /disci  delac 

Names :  -  - 

description 
Parameters : 


DI SP  LAY_COMMAND_L 1ST 

Display  information  about  the  command  list. 

Syntax:  DISPLAY_COMMAND_LIST  -or- 

DISCL 


0  or  OUTPUT=f i 1 e 

DO  or  DISPLAY_OPTIONS=l ist  of  keyword 
STATUS'S tatus  variable 

Parameters:  DO  -  display  option 

ab  option  meaning 


E  ENTRY  all  entry  names 

SM  SEARCH_MODE  the  command  list  search 

mode 

ALL  E  +  SM 

(default:  ENTRY) 
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Examples:  /disci 

:nve . culwe . ds . command_l ibrary . 5 
:nve.nsys . helps_proclib.  10 
:nve.nsys.proclib.60 

:nve . $sys tem_f i 1 es . ,  dtrc_user__l  ibrary . 1 

: local 

$system 

:$system.$system. application. app$command_l ibrary. 2 

/ 


DISPLAY_COMMAND_LIST_ENTRY 

Display  information  about  one  or  more  entries  in  a  command 
list. 

Syntax:  DISPLAY_COMMAND_LIST_ENTRY  -or- 

DISCLE 


E  or  ENTRIES  or 

ENTRY=list  of  name  or  file 
DO  or  DISPLAY_ OPTIONS^ 1 i s t  of  keyword 
0  or  OUTPUT=f i le 

STATUS=status  variable 


Parameters:  E  -  command  list  entry  or  entries 

CS  or  CONTROL_STATEMENT  -  display  SCL 
control  statement  and 
commands 

F  or  FIRST  -  first  entry  in  command  list, 
allowing  a  display  of  the 
subcommands  of  an  active 
utility 

ALL  -  the  entire  sommand  list 

including  control  statements 
(default:  FIRST) 


DO 


the  contents  of  the  output 
ab  option  meaning 


N 


AN 


C 

F 

AU 


NAME 


ALL  NAMES 


COMMAND 
FUNCTION 
ADVANCED  USAGE 


names  of  commands, 
functions,  or  control 
statements  (depending 
on  other  DOs) 
all  names  including 
abbreviat ions  and 
aliases 

individual  commands 
individual  functions 
commands  and  functions 
with  ADVANCED  attribute 


ALL  all  other  options 

(default:  COMMAND, NAME; 
if  COMMAND  and  FUNCTION  omitted:  COMMAND) 


Examples : 


/discle  . nsys  . prod  ib 

<displays  2-column  list  of  routines  in  PROCLIB* 
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DISPLAY_CONNECTION_ATTRIBUTES 

Display  the  terminal  file's  connection  attributes. 

Syntax:  DISPLAY_CONNECTION_ATTRIBUTES  -or- 

DISPLAY_CONNECTION_ATTRIBUTE  -or- 
DISCA  -or- 

DI SPLAY_TERM_CONN_ATTR I BUTE  -or- 

DISPLAY_TERM_CONN_ATTRIBUTES  -or- 
DISTA 

TFN  or  TERMINAL  FILE  NAME=f i le 


DO  or  DISPLAY_0PTI0N  or 

DISPLAY_OPTIONS= list  of  name 
0  or  0UTPUT=  file 

STATUS=status  variable 

Parameters:  TFN  -  the  terminal  file  name 

DO  -  see  CHANGE_CONNECTION_ATTRIBUTES 
(default:  ALL) 

Similar  commands:  VMS:  SHOW  TERMINAL 


DISPLAY_FILE 

Display  a  file  in  hexadecimal  and/or  ASCII. 

Syntax:  DISPLAY_FILE  -or~ 

DISF 

I  or  INPUT=f i le 


0  or  0UTPUT=f ile 

F  or  FORMAT  or  FORMATS=list  of  keyword 
BA  or  BYTE_ADDRESSE  or 

BYTE_ADDRESSES=1 ist  of  range  of  integer 
STATUS=s tatus  variable 

Parameters:  F  -  the  display  format 

f  meaning 

ASCII  display  in  ASCII 
HEX  display  in  hexadecimal 
(default:  ASCII, HEX) 

BA  -  address  ranges  to  be  displayed 

(default:  the  complete  from  from  the  open 
pos i t i on) 

Similar  commands:  NOS:  TAPEDMP  (DTRC) ;  TDUMP 

VMS:  DUMP 
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Examples:  /display_f i le  myfile  f=ascii 

A—  the  file  in  ASCII 
/disf  myfile  f=  (ascii ,hex) 

A —  the  file  in  ASCII  and  hexadecimal 
/disf  myfile  ba= (3. . 8 , 16 . . 24, 56. . 88) 

A —  bytes  3  thru  8,  16  thru  24,  and 
56  thru  88  in  ASCII  and 
hexadecimal 


DISPLAY_FILE_ATTRIBUTES 

Display  selected  attributes  of  one  or  more  files. 

Syntax:  DISPLAY_FILE_ATTRIBUTES  -or- 

DISPLAY_FILE_ATTRIBUTE  -or- 
DISFA 

F  or  FILES  or  FILE=list  of  file 


DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=list  of  keyword 
0  or  0UTPUT=f i le 

STATUS=status  variable 

Parameters:  DO  -  the  attributes  to  display 

ab  option 

AM  ACCESS_MODE 

ARL  AVERAGE_RECORD_LENGTH 

BT  BLOCK_TYPE 

CC  CHAR ACTER_C0N VER  SION 

CTN  COLLATE_TABLE_NAME 

CPN  COMPRESS ION_PROCEDURE_NAME 

DP  DATA_P ADDING 

EK  EMBEDDED_KEY 

EEN  ERROR_EXIT_NAME  or 

EEPN  ERROR_EXIT_PROCEDURE_NAME 

EL  ERR0R_LIMIT 

ERC  ESTIMATED_RECORD_COUNT 

FAP  F I LE_ACCESS_PROCEDURE  or 

FAPN  F ILE_ACCESS_PROCEDURE_NAME 

FC  FILE_CONTENTS 

FLT  FILE_LABEL_TYPE 

FL  FILE_LIMIT 

FO  FILE_ORGANIZATION 

FP  FILE_PR0CESS0R 

FS  FILE_STRUCTURE 

FW  FORCED_WRITE 

HPN  HASHING_PROCEDURE_NAME 

IL  INDEX_LEVEL 

IP  INDEX_PADDING 

IHBC  INITIAL_H0ME_BL0CK_C0UNT 

IC  INTERNAL_CODE 

KL  KEY  LENGTH 

KP  KEY_POSITION 

KT  KEY  TYPE 
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LN 

LINE_NUMBER 

LET 

LOCK_EXP IRAT I ON_T IME 

LO 

LOGGING_OPTIONS  or  LOGGING  OPTION 

LR 

LOG_RESIDENCE 

MAXBL 

MAXIMUM_BLOCK_LENGTH 

MAXRL 

MAXIMUM  RECORD  LENGTH 

MC 

MESSAGE  CONTROL 

MINBL 

MINIMUM  BLOCK  LENGTH 

MINRL 

MINIMUM_RECORD  LENGTH 

OP 

OPEN_POSITION 

PC 

PADDING_CHARACTER 

PF 

PAGE_FORMAT 

PL 

PAGE_LENGTH 

PW 

PAGE_WIDTH 

PV 

PRESET_VALUE 

V  L 

RECORD_LIMIT 

RT 

RECORD__TYPE 

RPB 

RECORDS  PER  BLOCK 

SI 

STATEMENT  IDENTIFIER 

UI 

USER_INFORMATION 

AI 

APPL I CAT ION_IN FORMAT ION 

S 

SIZE  (file  length  in  bytes) 

GAM 

GLOBAL  ACCESS  MODE 

GFA 

GLOBAL~FILE  ADDRESS  (returns  READ 
WRITE,  APPEND,  MODIFY,  SHORTEN) 

GFN 

GLOBAL  FILE  NAME 

CFP 

GLOBAL  FILE  POSITION  ("returns  BOI 
BOP,  MID  RECORD,  EOR,  EOP,  EOl) 

GSM 

GLOBAL__SHARE  MODE  (returns  NONE, 
READ,  WRITE,  APPEND,  MODIFY, 
SHORTEN,  EXECUTE) 

P 

PERMANENT  (true  or  false) 

RA 

RING  ATTRIBUTES 

(default:  FC,  FP,  FS,  GAM,  P,  S) 

See  also:  SET_FILE_ATTRIBUTES 

Similar  commands:  COS:  AUDIT 

NOS:  CATLIST 
VMS:  DIRECTORY/FULL 


Examples:  /disfa  my_file  do=(am,s,p) 


DISPLAY_FILE_CONNECTIONS 

Display  the  names  of  the  files  currently  connected  to  the 
subject  files. 

Syntax:  DISPLAY_FILE_CONNECTIONS  -or- 

DISPLAY_FILE_CONNECTION  -or~ 

DISFC 

SF  or  STANDARD_FILES=keyword  or  list  of  file 
0  or  OUTPUT=f i le 

STATUS=status  variable 
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DISPLAY 


DISPLAY 


See  also:  CREATE_FILE_CONNECTION ;  DELETE_FILE_CONNECTION 

Examples:  /disfc 


FUNCTION_INFORMAT ION 
Display  information  about  a  function. 

Syntax:  DISPLAY_FUNCTION_INFORMATION  -or- 

DISFI 

F  or  FUNCTION=data  name 


0  or  OUTPUT=f i 1 e 
DO  or  DISPLAY_0PTI0N  or 

DISPLAY_OPTIONS=l ist  of  keyword 
STATUS=status  variable 


Parameters:  DO  -  type  of  information  to  display 

(same  as  DISPLAY_COMMAND_INFORMATION) 

Remarks:  System  variable  OSD$DISFI_DISPLAY_OPTIONS  has  the 

d  fault  display  options. 


Examples:  /disfi  my_func 


INPUT_ATTRIBUTE 

Display  the  input  attributes  of  a  queued  or  processing  job. 

Syntax:  DISPLAY_INPUT_ATTRIBUTE  -or- 

DISPLAY_INPUT_ATTRIBUTES  -or- 
DISIA 

N  or  NAME  or 

NAMES=list  of  name 


DO  or  DISPLAY_OPTION  or 

DISPLAY_0PTI0NS=1 ist  of  keyword 
0  or  0UTPUT=f i le 

STATUS=s tatus  variable 

Parameters:  N  -  the  names  of  the  jobs  whose  attributes  are 

to  be  displayed 

DO  -  the  information  to  display 
ab  option 

ALL 

CB  COMMENT_BANNER 

CF  C0NTR0L_FAMILY 

CU  CONTROL_USER 

L  COPIES 

CTL  CPU_TIME_LIMIT 

DM  DATA_M0DE 

D  DEVICE 

EPT  EARLIEST_PRINT_TIME 
ERT  EARLIEST  RUN  TIME 
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EC 

EXTERNAL_CHARACTER I ST ICS 

FC 

FORMS_CODE 

JAD 

JOB  ABORT  DISPOSITION 

JC 

JOB_CLASS 

JDBO 

JOB_DEFERRED  BY_OPERATOR 

JDBU 

JOB_DEFERRED  BY  USER 

JD 

JOB_DESTINATION 

JDU 

JOB_DEST I NATION  USAGE 

JER 

JOB  EXECUTION  RING 

JM 

JOB_MODE 

JQ 

JOB_QUALIFIER  or  JOB  QUALIFIERS 

JRD 

JOB  RECOVERY  DISPOSITION 

JS 

JOB  SIZE 

JST 

JOB  SUBMISSION  TIME  or  QT  or 
QUEUED  TIME 

LPT 

LATEST  PRINT  TIME 

LRT 

LATEST  RUN  TIME 

LA 

LOGIN  ACCOUNT 

LF 

LOGIN_FAMILY 

LP 

LOGIN~PROJECT 

LU 

LOGINJJSER 

MTL 

MAGNETIC  TAPE  LIMIT 

MAXWS 

MAXIMUM  WORKING_SET 

OF 

OPERATOR  FAMILY  or  DF  or 
DESTINATION  FAMILY 

OU 

OPERATOR  USER  or  SO  or 

STATION  OPERATOR 

OAN 

ORIGINATION  APPLICATION  NAME 

OC 

OUTPUT  CLASS 

ODBU 

OUTPUT  DEFERRED  BYUSER 

ODE 

OUTPUT  DESTINATION 

ODU 

OUTPUT  DESTINATION  USAGE  or  DU 

ODI 

OUTPUT  DISPOSITION 

OP 

OUTPUT  PRIORITY 

PD 

PURGE  DELAY 

RHD 

REMOTE  HOST  DIRECTIVE 

RB 

ROUTING  BANNER 

SI 

SITE  INFORMATION 

SL 

SRU_LIMIT 

S 

STATION 

SJN 

SYSTEM  JOB  NAME 

UI 

USER_INFORMATION 

UJN 

USER  JOB  NAME 

VPD 

VERTICAL  PRINT  DENSITY 

VLP 

VFU_LOAD  PROCEDURE 

(default 

::  ALL) 

SCL  funct  ion:  $JOB_INPUT  -  determine  the  input  attributes  of 

a  job 

Examples:  /disia  my_job  (js,sjn) 
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DISPLAY  JOB  ATTRIBUTE 

• 

Display  the 

attributes  of 

your  current  job. 

Syntax : 

DISPLAY  JOB 

ATTRIBUTE  -or- 

DISPLAY  JOB 

ATTRIBUTES  -or- 

DISJA 

DO  or  DISPLAY  OPTION  or 

DISPLAY  OPTIONS=list  of  keyword 

0  or  OUTPUT=f i I e 

STATUS=status  varia  le 

Parameters : 

DO  -  the  information  to  display 

ab 

option 

ALL 

CB 

COMMENT  BANNER 

CF 

CONTROL  FAMILY 

cu 

CONTROL  USER 

c 

COPIES 

CAI 

CYCLIC  AGING  INTERVAL 

DJWT 

DETACHED  JOB  WAIT  TIME 

D 

DEVICE 

DP 

DISPATCHING  PRIORITY 

EPT 

EARLIEST  PRINT  TIME 

ERT 

EARLIEST  RUN  TIME 

EC 

EXTERNAL  CHARACTERISTICS 

FC 

FORMS  CODE 

JAD 

JOB  ABORT  DISPOSTTION 

JC 

JOB  CLASS 

JM 

JOB  MODE 

JQ 

JOB  QUALIFIER  or  JOB  QUALIFIERS 

JRD 

JOB  RECOVERY  DISPOSITION 

JS 

JOB  SIZE 

JST 

JOB  SUBMISSION  TIME  or  QT  or 

QUEUED  TIME 

LPT 

LATEST  PRINT  TIME 

LRT 

LATEST  RUN  TIME 

LA 

LOGIN  ACCOUNT 

LF 

LOGIN  FAMILY 

LP 

LOGIN  PROJECT 

LU 

LOGIN  USER 

MAXWS 

MAXIMUM  WORKING  SET 

MINWS 

MINIMUM  WORKING  SET 

OF 

OPERATOR  FAMILY  or  DF  or 

DESTINATION  FAMILY 

OU 

OPERATOR  USER  or  SO  or 

STATION  OPERATOR 

OAN 

ORIGINATION  APPLICATION  NAME 

OC 

OUTPUT  CLASS 

ODBU 

OUTPUT  DEFERRED  BY  USER 

ODE 

OUTPUT  DESTINATION 

ODU 

OUTPUT  DESTINATION  USAGE  or  DU 

ODI 

OUTPUT  DISPOSITION 

OP 

OUTPUT  PRIORITY 
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PAI 

PAGE_AGING  INTERVAL 

PD 

PURGE_DELAY 

RHD 

REMOTE_HOST  DIRECTIVE 

RB 

ROUTING  BANNER 

SS 

SENSE  SWITCHES 

SC 

SERVICE  CLASS 

SI 

SITE  INFORMATION 

S 

STATION 

SJN 

SYSTEM_J0B  NAME 

UI 

USER_INFORMATION 

UJN 

USER_JOB  NAME 

VPD 

VERTICAL  PRINT_DENSITY 

VLP 

VFU  LOAD  PROCEDURE 

(def aul t 

:  ALL) 

SCL  function:  $JOB  -  determine  the  input  attributes  of  your 

j  ob 


Examples:  /disja 


DISPLAY_JOB_ATTRIBUTE_DEFAULTS 

Display  the  current  defaults  for  the  job  attributes. 

Syntax:  DISPLAY_JOB_ATTRIBUTE_DEFAULT  -or- 

DISPLAY__JOB_ATTRIBUTE_DEFAULTS  ~or~ 
DISJAD 


JM  or  J0B_M0DE=keyword  or  list  of  keyword 
DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS= 1 i s t  of  keyword 
0  or  OUTPUT=f i 1 e 

STATUS=status  variable 


Parameters:  JM  -  job  modes  for  the  display 

jm  meaning 


ALL  batch  and  interactive 

BATCH  batch  only 

INTERACTIVE  interactive  only 

DO  -  job  attribute  defaults  to  be  displayed 
ab  attribute 


ALL 

CTL 

CPU_TIME  LIMIT 

JAD 

JOB  ABORT  DISPOSITION 

JC 

J0B_CLASS 

JBDO 

JOB  DEFERRED  BY  OPERATOR 

JM 

JOB_MODE 

JQ 

JOB_QUALIFIER  or  JOB  QUALIFIERS 

LF 

LOGIN_FAMILY 

MTL 

MAGNETIC  TAPE_LIMIT 

MAXWS 

MAXIMUM  WORKING  SET 
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DISPLAY 


DISPLAY 


oc 

OUTPUT_CLASS 

ODBU 

OUTPUT_DEFERRED  BY 

USER 

0DU 

output_destination" 

'USAGE  or  DU 

PD 

PURGE_DELAY 

SI 

SITE_ INFORMAT I ON 

SL 

SRU  LIMIT 

S 

STATION 

VPD 

VERTICAL  PRINT  DENSITY 

VLP 

VFU  LOAD  PROCEDURE 

(default:  ALL) 

SCL  function:  $ JOB_DEFAULT 
See  also:  CHANGE  JOB  ATTRIBUTE 


Examples:  /disjad 


JOB_LIMITS 

Display  your  job's  limits. 

Syntax:  DISPLAY_JOB_LIMIT  -or- 

DISPLAY_JOB_LIMITS  -or- 
DISjL 


0  or  0UTPUT=f i le 

STATUS=status  variable 

Remarks:  DISJL  displays  the  count,  warning  and  maximum 

limits  for  CP_TIME,  MAGNET I C_TAPE,  PERMANENT_ 
FILE_SPACE,  SRU ,  TASK,  TEMPORARY_FILE_SPACE . 

SCL  function:  $JOB_LIMIT 

Examples:  /disjl 


JOB_STATUS 

Display  current  status  of  queued  or  executing  jobs. 

Syntax:  DISPLAY_JOB_STATUS  -or- 

DISJS  -or- 

DISPLAY_INPUT_STATUS  -or- 
DISIS 


N  or  NAME  or  NAMES  or  JN  or  J0B_NAME  or 
JOB_NAMES=keyword  or  list  of  name 
DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=list  of  keyword 
0  or  0UTPUT=f i le 

STATUS=status  variable 
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Parameters:  N  -  one  or  more  jobs  whose  status  is  to  Ke 

displayed 

DO  -  the  information  to  be  displayed 
ab  option 

ALL 

CF  CONTROL_FAMILY 

CU  CONTROLJJSER 

CTU  CPU_TIME_USED 
DM  DISPLAY_MESSAGE 
JC  JOB_CLASS 

JCP  JOB_CLASS_POSITION 
JDU  JOB_DESTINATION  USAGE 
JIT  JOB_INITIATION_TIME 
JM  JOB_MODE 

JS  JOB_STATE  (returns  DEFERRED,  QUEUED, 

INITIATED,  TERMINATED) 

LF  LOGIN_FAMILY 

LU  LOGIN_USER 

OAP  OPERATOR_ACTION_POSTED 

PF  PAGE_FAULTS 

SJN  SYSTEM_JOB_NAME 

UJN  USER_JOB_NAME 

(default:  the  value  of  OSD$DISJS_DISPLAY_ 
OPTIONS;  if  not  defined:  CTU,  DM, 
JC,  JF,  SJN) 

Remarks:  (ncc)S  will  do  this  at  any  time  ((ncc)  is  your 

network  command  character) . 

(ncc) J  will  do  this  for  all  your  jobs  at  any  time. 

System  variable  OSD$DISJS_DISPLAY_OPTIONS  has  the 
default  display  options. 

SCL  function:  $JOB_STATUS 

Similar  commands:  NOS:  ENQUIRE, JSN 

VMS:  SHOW  PROCESS;  SHOW  QUEUE;  SHOW  SYSTEM 


Examples:  /disjs 


DISPLAY_LINK_ATTRIBUTES 

Display  individual  link  attribute  values. 

Syntax:  DISPLAY_LINK_ATTRIBUTES  -or- 

DISLA 


DO  or  DISPLAYOPTION  or 

DI SPLAY_OPTIONS= list  of  keyword 
0  or  0UTPUT=f i 1 e 

STATUS=status  variable 
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Parameters:  DO  -  display  options 

ab  option 


meaning 


C 

F 

P 

U 


ALL  all  attributes 

CHARGE  NOS  charge  number 

(not  used  at  DTRC) 
FAMILY  NOS  family  name 

PROJECT  NOS  project  number 
(not  used  at  DTRC) 
USER  NOS  username 


Examples:  /disla 

CHARGE  : 

FAMILY  :  nlfam 
PROJECT  : 

USER  :  AMDS 

/ 


DISPLAY_LOG 

Display  the  job  log  for  the  requesting  job. 

Syntax:  DISPLAY_LOG  _or~ 

DISL 


JO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=keyword  or  integer 
0  or  OUTPUT=file 

STATUS=s tatus  variable 


the 

por t i on 

of  the 

log 

to  be  displayed 

ab 

option 

meaning 

A 

ALL 

start 

at 

the  beginning  of  the 

log 

L 

LAST 

start 

wi 

th  the  first  message 

after 

the  last  DISL 

intege 

r  the  1 

as  t 

n  messages  of  the  log 

and  the 

current  message 

Remarks:  The  display  includes: 

.  time  stamp 
.  message  origin 

Cl  ~  command  interpreted 
CS  ~  command  skipped 
PR  ~  program  generated 
RC  -  job  recovery 
SY  _  system  generated 
.  message  text 


(ncc)L  will  do  this  at  any  time  ((ncc)  is  your 
network  command  character) . 
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Similar  commands:  NOS:  DAYFILE 

VMS:  SET  VERIFY;  TYPE  job. LOG 

Examples:  /disl  1 


DISPLAY_MESSAGE 

Display  a  message  in  one  or  more  logs. 

Syntax:  DISPLAY_MESSAGE  -or- 

DISM 

M  or  MESSAGE=string 


T  or  T0=list  of  keyword 

STATUS=s tatus  variable 

Parameters:  T  -  the  messag  destination 

option  how  to  view 


J0B_MES3AGE  DISPLAY_JOB_STATUS 

JOB  DISPLAY_LOG 

JOB_S TATI STIC 
ALL 

(default:  JOB) 

Similar  commands:  NOS:  COMMENT;  DISPLAY 
Examples:  /dism  "Running  my_prog" 


DI SPLAY_OB JECTLIBRARY 

Display  information  about  an  object  library,  object  file, 
procedure  file. 


Syntax:  DISPLAY_OB JECT_LIBRARY  -or- 

DISOL 

L  or  LIBnARY=file 


M  or  MODULE  or 

M0DULES=list  of  range  of  any 
DO  or  DISPLAY_OPTION  or 

DISPLAY_0PTI0NS=1 ist  of  keyword 
0  or  0UTPUT=f i 1 e 
AO  or  ALPHABETICAL_ORDER=boclean 
STATUS=s tatus  variable 


Parameters:  L 

M 


the  file  to  be  displayed 

the  list  of  modules  to  display 

(use  a  string  variable  for  non-SCL  name) 


or 
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DO  -  display  options 
ab  option 

NONE  (type  and  name) 

DT  DATE_TIME 

EP  ENTRY_POINT 
H  HEADER 

L  LIBRARY  or  LIBRARIES 

R  REFERENCE 

C  COMPONENT 

ALL 

(default:  DT) 

AO  -  TRUE  =>  alphabetical  listing 

FALSE  =>  list  in  order  the  modules  exist 
in  the  file 
(default:  FALSE) 


Remarks:  Although  modules  may  be  mixed  in  a  library,  you 

may  wirh  to  put  programs,  subprograms,  procedures, 
and  procedure  helps  (oi  procedures  and  their 
helps)  into  separate  libraries. 

See  also:  COMPARE_OBJECT_LIBRARY ;  CREATE_C ■ JECT_L1BRARY ; 

DISPLAY  OBJECT  TEXT 


Similar  commands:  COS,  NOS:  ITEMIZE 

VMS:  LIBRARY 


Examples:  /disol  anylib 

Display  of  object  library  -  anylib  09:48:23  05/09/90  PAGE  1 


LEN_TRIM 

GEIAC 

GETUJN 

FICHE 

XEROX 

$UNREAD_M\IL 
HELP_FICHE$US_ENGLISH 
HELP  XEROXSUS  ENGLISH 


-  load  module 

-  load  module 

-  load  module 

-  command  procedure 

-  command  procedure 

-  function  procedure  - 
~  message  module 

-  message  module 


13:13:28  1990-02-28 
13:05:25  1990-03-02 
13:05:25  1990-03-02 
12:05:18  1990-04-05 
12:06:24  1990-04-05 
14-23:57  1990-05-03 
11:08:37  1990-04-05 
11:08:40  1990-04-05 


DISPLAY_OBJECT_TEXT 

Display  object  records  of  an  object  library  or  file. 

Syntax:  DISPLAY_OB JECT_TEXT  -or- 

DISOT 


F  or  FILE=f  i  le 

O  or  OUTPUT=f i  1  e 

DHR  or  DISPLAY_HEX_RECORDS= boo  lean 
STATUS=s ta tus  variable 
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Parameters:  F  -  (default:  LGO) 

DHR  -  controls  whether  large  hexadecimal  fields 
(such  as  a  code  section)  should  be 
displayed 
(default:  TRUE) 


See  also:  COMPARE_OBJECT_LIBRARY;  CREATE_OBJECT_LIBRARY; 

DISPLAY_OBJECT_LIBRARY 

Examples:  /disot 


DISPLAY_OUTPUT_ATTRIBUTE 

Display  attributes  of  an  output  file. 

Syntax:  DISPLAY_OUTPUT_ATTRIBUTE  -or- 

DISPLAY_OUTPUT_ATTRIBUTES  -or~ 
DISOA 

N  or  NAMES  or  NAME=file 


DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=keyword  or 

list  of  keyword 

0  or  OUTPUT=file 

STATUS=status  variable 


Parameters:  N  -  (system-  or  user-supplied  name  of  the  file 

to  be  displayed 


isplay  options 

ab 

option 

ALL 

CB 

COMMENT  BANNER 

CF 

CONTROL  FAMILY 

CU 

CONTROL  USER 

C 

COPIES 

CP 

COPIES  PRINTED 

DM 

DATA  MODE 

D 

DEVICE 

DT 

DEVICE  TYPE 

EPT 

EARLIEST  PRINT  TIME 

EC 

EXTERNAL  CHARACTERISTICS 

FP 

FILE  POSITION 

FS 

FILE  SIZE 

FC 

FORMS  CODE 

LPT 

LATEST  PRINT  TIME 

LA 

LOGIN  ACCOUNT 

LF 

LOGIN  FAMILY 

LP 

LOGIN  PROJECT 

LU 

LOGIN  USER 
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OF  OPERATOR_FAMILY  or  DF  or 
DESTINATION_FAMiLY 
OU  OPERATOR_USER  or  SO  or 

STATION_OPERATOR 

OAN  ORIGINATING_APPLICATION_NAME 
OC  OUTPUT_CLASS 

ODBO  OUTPUT_DEFERRED_BY_OPERATOR 
ODBU  OUTPUT_DEFERRED_BY_USER 
ODE  OUTPUT_DEST INAT I ON 

ODU  OUTPUT_DESTINATION_USAGE  or  DU  or 
DESTINATIONJJSAGE 
OP  OUTPUT_PRIORITY 

OST  OUTPUT_SUBMISSION_TIME  or  QT  or 

QUEUED_TIME 
PD  PURGE_DELAY 

RHD  REMOTE_HOST_DIRECTIVZ  or  DSRP  or 
DUAL_STATE_ROUTE_PARAMETERS 
RB  ROUTING_BANNER 

SI  SITE_INFORMATION 

S  STATION 

SJN  STATION_JOB_NAME 

UFN  USER_FILE_NAME 

UI  USER_INFORMATION 

UJN  USER_JOB_NAME 

VPD  VERTICAL_PRINT_DENSITY 

VLP  VFU_LOAD_PROCEDURE 

SCL  function:  $JOB  OUTPUT 


Examples:  /disoa  my_job  sjn 


DISPLAY_OUTPUT_HISTORY 

Display  job  log  entries  for  output  files. 

Syntax:  DISPLAY_OUTPUT_HISTORY  -or- 

DISOH 


OFN  or  OUTPUT_FILE_NAME= 1 i s t  of:  keyword  or 

name 

JN  or  JOB_NAME=l i s t  of:  keyword  or  name 
LF  or  LOGIN_FAMILY= 1 i s t  of:  keyword  or  name 
BLP  or  BEGINNING_LOG_POSITION=keyword 
SO  or  SORTED_ORDER=keyword 
0  or  OUTPUT=file 

STATUS=s tatus  variable 


Examples 


/d i soh 
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DISPLAY 


DISPLAY 


OUTPUT_STATUS 

Display  the  status  of  a  file  in  the  output  queue. 


Syntax:  DISPLAY_OUTPUT_STATUS  -or- 

DISOS  -or- 

DISPLAY_PRINT_STATUS  -0r~ 
DISPS 


N  or  NAME=keyword  or  list  of  name 
DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=keyword  or  list  of 
keyword 

0  or  0UTPUT=f i le 

STATUS=s tatus  variable 


Parameters:  N  -  the  files  to  be  displayed 


DO  -  display  options 

ab  option 

ALL 

CB  COMMENT_BANNER 

CF  CONTROL_FAMILY 

CU  C0NTR0L_USER 

LF  LOGINJPAMILY 

LU  LOGINJJSER 

ODU  OUTPUT_DESTINATION_USAGE 
OP  0UTPUT>RI0RITY 

OS  OUTPUT_STATE 

(returns  DEFERRED,  QUEUED, 
INITIATED,  TERMINATING,  COMPLETED) 
SFN  SYSTEM_FILE_NAME 
SJN  SYSTEM_JOB_NAME 

UFN  USER_FILE_NAME 

(default:  OS,  SFN,  UFN) 

SCL  function:  $0UTPUT_STATUS 

Similar  commands:  COS:  CRAY>  STATUS  /O  (from  VAXcluster) 

NOS:  ENQUIRE, JSN;  Q 
VMS:  SHOW  QUEUE 

Examples:  /disos 


PROGRAM_ATTR IBUTES 

Display  the  current  job  library  list  and  default  execution 
option  values. 

Syntax:  DISPLAY_PROGRAM_ATTR IBUTES  -or- 

DI SPLAY_PROGRAM_ATTR I BUTE  -or- 
DISPA 


0  or  0UTPUT=f i 1 e 

STATUS=status  variable 
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See  also:  SET_PROGRAM_ATTRIBUTES 

Examples:  /dispa 


DISPLAY_SCL_OPTIONS 

Display  the  options  set  by  CHANGE_SCL_OPTIONS . 

Syntax:  DISPLAY_SCL_OPTIONS  -or- 

DISPLAY_SCL_OPTION  -or- 
DISCLO  -or- 

DISSO 


0  or  OUTPUT=file 

STATUS=s tatus  variable 

SCL  function:  $SCL_OPTIONS  -  the  values  set  by 

CHANGE_SCL_OPTIONS 

Examples:  /disso 

Line_Stype_Correct ion_Prompts  :  line 

Screen_Stype_Correct ion_Prompts  :  screen 

Name_Folding_Level  :  standardf olding 

Wi ld_Card_Pattern_Type  :  extended 


DISPLAY_TAPE_LABEL_ATTRIBUTES 

Display  the  current  magnetic  tape  label  attributes. 

Syntax:  DISPLAY_TAPE_LABEL_ATTRIBUTES  -or- 

DISPLAY_TAPE_LABEL_ATTRIBUTE  -or- 
DISTLA 

F  or  FILE=file 

DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS= list  of  name 
0  or  OUTPUT=file 

STATUS=status  variable 

Parameters:  DO  -  display  options 

ab  option 

BT  BLOCKJTYPE 

BO  BUFFER_OFFSET 

CC  CHARACTER_CONVERSION 

CS  CHARACTER_SET 

CD  CREATION_DATE 

ED  EXPIRATION_DATE 

FAC  F I LE_ACCES  SIBIL I T Y_CODE 

FI  FILE_IDENTIFIER 

FSN  FILE_SEQUENCE_NUMBER 

FSI  FILE_SET_IDENTIFIER 

FSP  FILE  SET  POSITION 
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DISPLAY 


DISPLAY 


See  also: 


GN 

GENERATION  NUMBER 

GVN 

GENERATION  VERSION  NUMBER 

MAXBL 

MAXIMUM  BLOCK_LENGTH 

MAXRL 

MAXIMUM  RECORD  LENGTH 

NF 

NEXT_FILE 

PC 

PADDING  CHARACTER 

RT 

RECORD  TYPE 

RL 

REWRITELABELS 

S 

SIZE  (file  length  in  bytes) 
ALL 

(default:  ALL,  NF) 

CHANGE  TAPE 

LABEL  ATTRIBUTES 

Examples:  /distla  na9876 


TASK_STATUS 

Display  the  status  of  one  or  more  tasks. 

Syntax:  DISPLAY_TASK_STATUS  -or- 

DISTS 

TN  or  TASK_NAME  or  TASK__NAMES=  list  of: 
keyword  or  name 


0  or  0UTPUT=f i 1 e 

STATUS=status  variable 

Parameters:  TN  -  the  name  of  the  task(s)  whose  status  is 

to  be  displayed 
ALL  -  all  tasks 

SCL  function:  $TASK_STATUS 

Examples:  /dists  all 


TERMINAL_ATTRIBUTES 

Display  interactive  terminal  attribute  values. 

Syntax:  DISPLAY_TERMINAL_ATTRIBUTES  -or- 

DISPLAY_TERMINAL_ATTRIBUTE  -or- 
DISTA 


DO  or  DISPLAY_OPTION  or 

DISPLAY_0PTI0NS=1 ist  of  name 
0  or  OUTPUT-file 

STATUS=status  variable 

Parameters:  DO  -  see  CHANGE_TERM INAL_ATTR I BUTES 
Similar  commands:  VMS:  SHOW  TERMINAL 


Examples 


/dista  (pl,pw) 
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DISPLAY_TERM_CONN_DEFAULTS 

Display  the  defaults  for  terminal  connection  attributes. 

Syntax:  DISPLAY_TERM_CONN_DEFAULTS  ~or- 

DISPLAY_TERM_CONN_DEFAULT  -or- 
DISTCD 


DO  or  DISPLAY_OPTION  or 

DISPLAY_0PTI0NS=1 ist  of  name 
0  or  OUTPUT=f i 1 e 

STATUS=status  variable 

Parameters:  DO  -  the  default  attribute  to  be  displayed 

(see  CHANGE_TERM_CONN_DEFAULTS  (CHATCD) ) 
(default:  ALL) 

Examples:  /distcd 


DISPLAY_TOPICS_FILE 

Open  a  Topics  online  manual. 

Syntax:  DISPLAY_TOPICS_FILE  -or- 

DISTF 

I  or  INPUT=f ile 


IE  or  INDEX_ENTRY=str ing 
ED  or  EXPAND_DEPIH= integer 
L  or  LIST=f ile 
IM  or  INDEX_MATCH=keyword 

STATUS=s tatus  variable 

See  also:  CREATE_TOPICS_FILE;  EXPLAIN;  HELP 

Examples:  See  Section  8-8. 


DISPLAY_VALUE 

Display  the  value  of  an  expression. 

Syntax:  DISPLAY_VALUE  -or- 

DISPLAY_VALUES  ~or- 
DISV 

V  or  VALUES  or  VALUE=any 


0  or  OUTPUT=file 
DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=] ist  of  keyword 
STATUS=status  variable 
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Parameters:  V  -  the  expression  to  be  evaluated  and  displayed 

DO  -  display  options 


ab 

opt i on 

CLE 

COMPRESSED  LABELED  ELEMENTS 

DS 

DATA  STRUCTURE 

DE 

DISPLAY  ELEMENTS 

E 

ELEMENTS  or  ELEMENT 

LE 

LABELED  ELEMENTS 

S 

SOURCE 

SCL  function:  $STRING 

See  also:  PUT_LINE 

Similar  commands:  NOS:  DISPLAY 

VMS:  WRITE 

Examples:  /v  =  154 

/disv  v 
154 
/ 


DISPLAY_VARIABLE_LIST 

Display  variables  accessible  to  the  current  block. 

Syntax:  DISPLAY_VARIABLL_LIST  -or- 

DISVL 


0  or  OUTPUT=file 

STATUS=status  variable 

SCL  function:  SVARIABLE 

Similar  commands:  VMS:  SHOW  SYMBOL 

Examples:  /disvl 

VARIABLES  IN  JOB 

mvv$have_mai 1 
c2f$libmalloc 
c2f$l ibm 
c2f$l ibrary 
f tf $1 ibrary 
tuf$library 
paf $1 ibrary 
aaf$44d_l ibrary 
smf $1 ibrary 


f df $1 ibrary 
c2f $run_t ime_l ibrary 
c2f $1 ibc 
adf $1 ibrary 

tuf $terminal_def ini t ions 
osf $sys  tem_l ibrary 
bcf $1 ibrary 
aaf $4dd_l ibrary 
ml f $1 ibrary 
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dbf$library  cbf$4dd_library 

flf$library  cyf$run_t ime_l ibrary 

osv$status 

/ 


DISPLAY_WORKING_CATALOG 

Display  your  working  catalog. 

Syntax:  DISPLAY_WORKING_CATALOG  -or- 

DISWC 


0  or  0UTPUT=f ile 

STATUS=s tatus  variable 

Similar  commands:  VMS:  SHOW  DEFAULT 

Examples:  /diswc 

:NVE. AMDS 

/ 


ECHO  (DTRC)  Control  echoing  of  SCL  statements  to  a  file. 

Syntax:  ECHO 

0  or  OPT  or  OPTION=keyword 
F  or  FILE=f ile 


STATUS=status  variable 

Parameters:  0  -  one  of: 

OFF  -  turn  echoing  off 
ON  -  turn  echoing  on 

F  -  the  echo  file 

Remarks:  Before  an  echo  file  can  be  examined,  echoing  to  it 

must  be  off. 

Similar  commands:  NOS:  DAYFILE 

VMS:  SET  VERIFY 

Examples:  /ECHO  ON  E 

<do  something> 

/ECHO  OFF  E 

/COPF  E  < —  echo  to  file  E  and  then  examine 
it 
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EDIT_CATALOG 

Begin  an  EDIT_CATALOG  utility  session  to  edit,  view,  copy, 
move,  print  your  files. 

Syntax:  EDIT_CATALOG  -or~ 

EDIC 


C  or  CATALOG=file 
DO  or  DISPLAY  OPTION  or 

DISPLAY~OPTIONS=keyword 
KDC  or  KEEP_DISPLAY_CURRENT=boolean 
NDF  or  N0_D0LLAR_F I LES 

STATUS=status  variable 

Parameters:  C  -  the  catalog  to  be  displayed/edited. 

(default:  the  current  working  catalog) 

DO  -  display  options 

ab  option  meaning 

A  ALL  display  all  file  attributes 

B  BRIEF  display  the  name  and  entry 

type  (file  or  catalog) 

(default:  BRIEF) 

KDC  -  TRUE  =>  update  display  after  each  operation 
FALSE  =>  update  only  after  home  line 

commands  and  some  other  operations 
(default:  FALSE) 

NDF  -  TRUE  =>  $  files  are  not  displayed 
(synonyms:  ON,  YES) 

FALSE  =>  $  files  are  displayed 
(synonyms:  OFF,  NO) 

(default:  FALSE) 

See  also:  ENTER  FILE  MANAGER 


Examples : 


/edic  do=a 

<list  of  files  with  keypad  options  to  manipulate 
them> 
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EDIT_DECK 

(SCU  subcommand)  Open  a  deck  in  the  working  library  for 
editing  while  maintaining  your  current  position  in  other  decks. 

Syntax:  EDIT_DECK  ~or~ 

EDID  -or- 

EDIT_LIBRARY  -or- 
EDIL~ 


D  or  DECK=keyword  or  name 
M  or  MODIFICATION=name 

I  or  INPUT=f i  le 

0  or  0UTPUT=f i  le 

P  or  PR0L0G=f ile 

DUC  or  DISPLAY_UNPR INTABLE_CHARACTERS=boo 1 ean 
STATUS=s tatus  variable 

Parameters:  D  -  the  deck  to  be  edited  (required  if  you  have 

never  entered  a  deck  on  a  DECK  parameter) ; 
if  it  does  not  exist,  it  is  created 
NONE  -  enter  editing  without  a  deck  name 
(default:  the  last  deck  used) 

Remarks:  If  you  unintentional ly  create  a  deck,  you  can 

discard  it  with: 

end  deck  write  deck=false  -or-  endd  wd=false 


EDIT_FILE 

Begin  a  file  editor  (EDIT_FILE  utility)  session. 

Syntax:  EDIT_FILE  ~or- 

EDIF 

F  or  FILE=f i le 


I  or  INPUT=f ile 

0  or  0UTPUT=f i 1 e 

P  or  PR0L0G=f i 1 e 

DUC  or  DISPLAY_UNPRINTABLE_CHARACTERS=boolean 

STATUS=status  variable 

Parameters:  I  -  subcommands  for  editing  the  file 

(default:  SCOMMAND) 

P  -  editing  subcommands  to  be  executed  each 
time  you  start  the  editor 
(def aul t :  $USER . SCU_EDIT0R_PR0L0G) 

DUC  -  TRUE  =>  unprintable  characters  (ASCII  127 
and  0-31)  are  displayed  as  <name> 
and  written  as  the  ASCII 
characters 


90/09/30 


RevO 


Page  H-85 


FALSE  =>  unprintable  characters  are 
displayed  as  a  space  with  a 
warning  message  AND  WRITTEN  as  a 
space 

(default:  FALSE) 

Remarks:  To  use  an  epilog  file  of  subcommands,  use 

SET_EPIL0G.  You  can  also  place  this  in  your 
prolog  file. 

To  edit  a  second  file  while  in  the  editor,  use 
EDIT_FILE. 

Subcommand  prompt:  ef/ 

Similar  commands:  NOS:  FSE 

VMS:  EDIT/TPU  (EVE);  EDT 

Examples:  /edif  my_file 


EMAIL  Begin  a  Mail/VE  session. 


Syntax : 


Remarks : 


EMAIL  -or- 
EMA 


OP  or  OPERATION=keyword 
0  or  OUTPUT=f ile 
E  or  ERR0R=file 
P  or  PROLOG=file 

STATUS=status  variable 

Parameters:  OP  -  the  operation  to  be  performed 

ab  op  meaning 


C  CHECK  check  your  mailboxes  for  mail 
R  READ  read  your  mail 
W  WRITE  compose  and  send  a  letter 

P  -  may  contain  Mail/VE  subcommands  or  SCL 
commands 

(SCL  default  name  variable  MVD$MAIL_PROLOG 
may  be  created  and  set  to  the  name  of  your 
prolog  file  (as  a  string)) 

EMAIL  operates  in  line  mode  or  screen  mode 
depending  on  the  interactive  style. 


Subcommand  prompt:  Mail/ 

Similar  commands:  VMS:  MAIL 

Examples:  /email  < —  read  your  mail 

/email  write 

A —  send  mail 
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ENCRYPT_FILE 

Encrypt  a  file  using  the  National  Bureau  of  Standards  Data 
Encryption  Standard  algorithm. 

Syntax:  ENCRYPT_FILE  -or- 

ENCF 

I  or  INPUT=f i 1 e 
0  or  OUTPUT=f i 1 e 

DK  or  DES_KEY=integer  or  string  or  name 


DM  or  DES_MODE=keyword 

DIV  or  DES_INITIAL_VECTOR=integer  or  string 

or  name 

PA  or  PRESERVE_ATTRIBUTES=bool ean 
STATUS=status  variable 

Parameters:  DK  -  (attribute:  SECURE) 

the  cryptographic  key 

type  requirement 


integer 


string 

name 


each  byte  of  the  binary 
representation  of  the  integer 
must  have  odd  parity 
exactly  8  ASCII-128  characters 
a  valid  NOS/VE  name  with  exactly 
8  characters 


DM  -  (attribute:  SECURE) 

the  decryption  mode  to  be  use 
ab  option  and  meaning 


ECB  ELECTR0NIC_C0DEB00K 

use  the  basic  Data  Encryption 
Standard  algorithm 
CBC  CIPHER_BLOCK_CHAINING 

use  the  cipher  block  chaining 
mode  of  operation 
CFB  CIPHER_FEEDBACK 

use  the  cipher  feedback  mode  of 
operation  (feedback  unit  data 
length  is  64  bits) 

OFB  OUTPUT_FEEDBACK 

use  the  output  feedback  mode  of 
operation  (feedback  unit  data 
length  is  64  bits) 

(default:  ELECTRON IC_C0DEB00K) 

DIV  -  (attribute:  SECURE) 

define  a  seed  value  for  CBC,  CFB,  OFB 
(ignored  for  ECB) 

(same  requirements  as  DK) 
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PA  -  TRUE  =>  NOS/VE  file  attributes  of  the 
input  file  are  preserved 
FALSE  =>  the  file  attributes  are  not 
preserved 

(the  length  of  the  input  file 
must  be  a  multiple  of  8  bytes) 

See  also:  DECRYPT_FILE 

Similar  commands:  VMS:  ENCRYPT  (DTRC) 

Examples:  /encf  plain_file  crypt_fyle  ABCD1234 


ENTER_FILE_MANAGER 

Begin  a  File  Manager  utility  session  to  view,  delete,  copy, 
print  files. 


Syntax:  ENTER_F I LE_MANAGER  -or- 

ENTFM 


C  or  CATALOG  or  F  or  FILE=file 
P  or  PROLOG=f i le 

STATUS=status  variable 

Parameters:  C  -  the  catalog  to  be  displayed  as  the  main 

display 

(default:  $WORKING_CATALOG) 

P  -  your  prolog  file  for  FM 

(default :  $USER . $F I LE_MANAGER . PROLOG) 

Remarks:  You  may  use  CREATE_DEFAULT_VARIABLE  to  define 

EUD$ENTFM_PROLOG  as  the  prolog  to  be  used. 

If  you  switched  your  working  catalog  for  this 
command,  you  can  keep  it  with  the  KEEP_CURRENT_ 
WORKING_CATALOG  parameter  of  the  QUIT  subcommand. 
Otherwise,  your  working  catalog  is  restored  to 
the  one  before  ENTFM  was  used. 


See  also:  EDIT_CATALOG 

Examples:  /entfm 


ENTER_PROGRAMMING_ENVIRONMENT 

Access  the  Programming  Environment. 

Syntax:  ENTER_PROGRaMMING_ENVIRONMENT  -or- 

ENTPE 


DP  or  DEFAULT_PROCESSOR= keyword 
EC  or  ENVIRONMENT_CATALOG=f i le 
STATUS=s tatus  variable 
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Parameters:  DP  -  one  of:  C,  COBOL,  CORAL,  FORTRAN  Version  1, 
FORTRAN  Version  2,  PASCAL 
(default:  FORTRAN) 

EC  -  the  catalog  in  which  PE  is  to  maintain  its 
files 

(def au’ t :  $USER . PROGRAMMING_ENVIRONMENT) 
Examples:  /entpe  ec=$user . proj_a 


EXECUTE_ COMMAND 

Execute  a 

Syntax : 


Parameters 


Remarks : 
Examples : 


single  command  asynchronously  in  a  new  task. 

EXECUTE_COMMAND  -or~ 

EXEC 

C  or  COMMAND=  string 


TN  or  TASK_NAME=name 
CF  or  COMMAND_F I LE=  file 
EE  or  ENABLE_ECHOING=boolean 
STATUS=status  variable 

C  -  the  command  to  be  executed 

TN  -  the  name  of  the  task 

CF  -  the  input  file  for  the  command  (used  as 
SCOMMAND) 

(default:  no  file  is  used) 

EE  -  YES  =>  the  command  is  echoed  to  the  terminal 
NO  =>  no  echoing 

Utility  commands  cannot  be  executed  this  way. 
/exec  'copy_file  filel  f i 1 e2 ' 


EXECUTE_ I NTER STATE_COMMAND 

Execute  a  NOS  command. 

Syntax:  EXECUTE_INTERSTATE_COMMAND  -or- 

EXEIC 


C  or  COMMAND=list  of  string 
STATUS=status  variable 

Parameters:  C  -  one  or  more  NOS  commands  to  be  executed 

CREATE_INTERSTATE_CONNECTION;  DELETE_ I NTER STATE 
CONNECTION 


See  also: 
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Examples:  /creic  < —  open  the  connection 

FA/exeic  ( '  BEGIN  .MSAUDI'i , ,  A.  '  ,  .. 

'REWIND, A.',  .. 

' FILE,A,BT=C,RT=Z,MRL=80. ') 

A —  the  NOS  dayfile  for  the  command 
is  displayed  and  put  into  file 
SLOCAL .  Z$Z//Z@Z_1 70_DAYFI  LE  — 
file  "A"  is  a  local  file  on  NOS 
FA/fmu_dir  =  $unique 

A —  get  unique  filename  for  FMU 
directives 

FA/collect_text  Slocal .  fmu__dir 

A —  create  file  of  FMU  (File 

Maintenance  Utility)  directives 
(prompt  wil  be  "ct?  ") 
ct?  SET_INPUT_ATTRIBUTES  A  C170 

A  —  —  "A"  is  the  NOS  local  file; 

"C170"  means  NOS  machine  format 
ct?  SET_OUTPUT_ATTR I BUTES  MSAUDIT_OUT 

A—  "MSAUDIT_OUT"  is  the  NOS/VE  file 

V?  Vr 

FA/include_line  ' fmu  dir=$local . temp ' 

A —  execute  FMU  to  copy  NOS  local 
file  to  NOS/VE  permanent  file 
FA/delic  < —  close  the  connection 

EXECUTE_TASK 

Execute  a  program. 

Syntax:  EXECUTE_TASK  ~or~ 

EXET 


F  or  FILES  or  FILE=list  of  file 
P  or  PARAMETERS  or  PARAMETER* list  of  file 
L  or  LIBRARIES  or  LIBRARY=string 
M  or  MODULES  or  M0DULE=list  of:  keyword  or 

file 

SP  or  STARTING_PROCEDURE=program_name 

LM  or  L0AD_MAP=f ile 

LMO  or  L0AD_MAP_0PTI0NS  or 

L0AD_MAP_0PTI0N=keyword  or 

list  of  keyword 
PV  or  PRESET_VALUE=keyword 

TEL  or  TERMINATION_ERROR_LEVEL=keyword 

SS  or  STACK_SIZF.=  integer 

DI  or  DEBUG_INTUT=f  ile 

DO  or  DEBUG_OUTPUT=  file 

AF  or  ABORT_FILE=f i le 

DM  or  DEBUG_MODE 'boolean 

TN  or  TASK_NAME=name 

AO  or  AR I THMET I C_OVER F LOW=b o o 1 ean 

ALOS  or  ARITHMETIC  LOSS  OF  SIGNIFICANCE=boolean 
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Parameters : 


DF  or 
EO  or 
EU  or 
FI  or 
FLOS  or 
IBD  or 


DIVIDE  FAULT=boolean 
EXPONENT_OVERFLOW=boolean 
EXPONENT_UNDERFLOW=bool ean 
FPI  or  FP_INDEFINITE=booIean 
FP_LOSS_OF_SIGNIFICANCE=boolean 
IBDPD  or  INVALID  BDP  DATA=booIean 


STATUS=status  variable 


F  -  object  files  or  libraries  to  be  loaded 
unconditionally 

(default:  determined  by  M  and  SP 

parameters;  if  all  omitted: 

$ LOCAL. LGO) 

P  -  passed  to  the  program  as  its  parameter 
list 

L  -  object  libraries  to  be  searched  (added  to 
start  of  program  library  list) 
OSF$TASK_SERVICES_LIBRARY  -  add  NOV/VE 
task  services  library  to  the  list 
(default:  program  library  list  contains: 

.  local  library  list 
.  NOS/VE  task  services  library 
.  text-embedded  libraries 
.  job  library  list 
.  job  debug  library  list  (if 
DM=0N) ) 

M  -  modules  to  be  loaded  unconditionally  from 
the  program  library  list  libraries 
(default:  determined  by  F  and  SP 

parameters;  if  F,  M,  SP  all 
omitted:  SLOCAL.LGO) 

SP  -  entry  point  to  begin  execution 

(default:  the  last  transfer  symbol  loaded) 

LM  -  file  to  hold  load  map 

(default:  job  default  value  (see  DISPLAY_ 
PROGRAM  ATTRIBUTES)) 


LMO  -  one  or  more  of: 

ab  lo  meaning 


NONE 

S  SEGMENT 
B  BLOCK 
EP  ENTRY_POINT 
CR  CROSS  REFERENCE 


ALL 
(default : 


no  load  map 
segment  map 
block  map 
entry  point  map 
entry  point  cross- 
reference 
all  maps 

default  load  map  option  (see 
DISPLAY  PROGRAM  ATTRIBUTES)) 
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PV  -  value  for  presetting  all  uninitialized 
program  memory 

ab  pv  meaning 


TEL 


Z 

FPI 


AO 


ZERO 

FLOATING_POINT 

INDEFINITE 

INFINITY 


ALTERNATE  ONES 


all  zeros 
floating-point 
indefinite 
floating-point 
inf ini te 

alternating  0  and 
1  bits  (leftmost 
is  1) 

(default:  job  default  value  (see  DISPLAY_ 
PROGRAM_ATTRIBUTES) ) 

WARNING  (W) ,  ERROR  (E) ,  FATAL  (F) 
(default:  job  default  value  (see  DISPLAY_ 
PROGRAM_ATTRIBUTES) ) 

(initial  default:  ERROR) 


SS  -  maximum  length  (bytes)  of  the  run-time 
stack 

(default:  job  default  value  (see  DISPLAY_ 
PROGRAM_ATTRIBUTES) ) 

DI  -  file  with  Debug  commands 

(default:  job  default  value  (see  DISPLAY_ 
PROGRAM_ATTRIBUTES) ) 

DO  -  file  to  hold  Debug  output 

(default:  job  default  value  (see  DISPLAY_ 
PROGRAM_ATTRIBUTES) ) 

AF  -  file  with  Debug  commands  if  program  aborts 
(default:  job  default  value  (see  DISPLAY_ 
PROGRAMATTRIBUTES)) 

DM  -  controls  Debug  mode  (ON  or  OFF) 

(default:  job  default  value  (see  DISPLAY_ 
PROGRAM_ATTRIBUTES)  ) 

TN  -  program  is  executed  asynchronously  and  is 
referred  to  by  this  name 
(default:  executed  synchronously) 

AO  -  controls  whether  arithmetic  overflow 
causes  an  interrupt  (ON  or  OFF) 

ALOS  -  controls  whether  arithmetic  loss  of 
significance  causes  an  interrupt 
(ON  or  OFF) 


DF  -  controls  whether  divide  fault  causes  an 
interrupt  (ON  or  OFF) 
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EO  -  controls  whether  exponent  overflow  causes 
an  interrupt  (ON  or  OFF) 

EU  -  controls  whether  exponent  underflow  causes 
an  interrupt  (ON  or  OFF) 

FI  -  controls  whether  floating  point  indefinite 
causes  an  interrupt  (ON  or  OFF) 

FLOS  -  controls  whether  floating  point  loss  of 
significance  causes  an  interrupt 
(ON  or  OFF) 

IBD  -  controls  whether  invalid  BDP  data  causes 
an  interrupt  (ON  or  OFF) 

See  also:  SET_PROGHAM_ATTRIBUTES 

Examples:  /execute_task  (objl,obj2) 

/exet  obj3  mdm=on 

EXIT  Transfer  control  out  of  a  structured  statement,  command  or 
function  procedure,  or  command  utility. 

Syntax:  EXIT 

designator 

WHEN  boolean  expression 
WITH  expression 

Parameters:  designator  -  the  labeled  structures  statement, 

command  procedure  or  utility  to  be 
exited 

bool_exp  -  TRUE  =>  the  enclosing  statement  is 

exited 

FALSE  =>  it  is  not  exited 
(default:  FALSE) 

expression  -  specifies  the  completion  status  of  a 
command  procedure  -or-  the  value 
returned  by  a  function  procedure: 
cmd  proc  -  must  have  type  STATUS 

(default:  normal  status) 
fen  proc  -  any  type  value 

Valid  forms:  EXIT  designator 

EXIT  WHEN  bool_exp 

EXIT  designator  WHEN  bool_exp 

EXIT  designator  WITH  expression 

EXIT  WHEN  bool_exp  WITH  expression 

EXIT  designator  WHEN  bool_exp  WITH  expression 
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Remarks:  The  WHEN  clause  is  evaluated  at  the  point  of 

reference,  instead  of  continually  (as  with  the 
WHEN  statement). 

WHEN  and  WITH  clauses  may  appear  separately  or 
together  (in  either  order) . 

Structured  statements  with  outstanding  calls  to 
other  blocks  (such  as  one  with  an  active 
INCLUDE_FILE)  cannot  be  exited. 

See  also:  WHEN 

Similar  commands:  NOS:  REVERT 

Examples:  PROCEDURE  test  (status) 

EXIT  test  WITH  .. 

$status(false, 'US' ,1, 'Test  failed') 


EXPAND_SOURCE_F I LE 

Expand  a  text  file  as  though  it  were  a  deck  in  an  SCU  library. 

Syntax:  EXPAND_SOURCE_FILE  -or~ 

EXPSF 

F  or  FILE=file 


C  or  C0MPILE=f ile 
DA  or  DEBUG_AIDS=keyword 
ISM  or  INPUT_SOURCE_MAP=f i 1 e 
OSM  or  OUTPUT_SOURCE_MAP=  file 
SC  or  SELECTION_CRITERIA=f i le 
W  or  WIDTH=integer 
LI  or  LINE_IDENTIFIER=keyword 
AB  or  ALTERNATE_BASE  or 

ALTERNATE_BASES= list  of  file 
L  or  LIST=f ile 
ED  or  EXPANS I0N_DEPTH= integer 
DO  or  DISPLAY_OPTION  or 

DISPLAYJDPTIONS=keyword 
STATUS=status  variable 

Parameters:  C  -  output  file  with  expanded  text 

(default:  COMPILE) 

DA  -  controls  the  disposition  of  screen  debugging 
information 

dt  meaning 

DT  write  it  to  OSM  file 
NONE  no  output 
(default:  NONE) 
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ISM  -  input  screen  debugging  information  for  F 

file  (output  source  map  from  when  the  file 
wsa  created) 

(default:  ) 

OSM  -  file  to  receive  screen  debugging  information 
(default:  OUTPUT_SOURCE_MAP) 

SC  -  file  with  selection  criteria  subcommands 

COMMAND  -  enter  subcommands  interactively 
(default:  no  selection  criteria) 

W  -  length  of  expanded  lines,  excluding  line 
identifiers 
(default:  0  (zero)) 

LI  -  line  identifier  placement 


ab 

option 

meaning 

R 

RIGHT 

to 

right  of  text 

L 

LEFT 

to 

left  of  text 

NONE 

no 

identifiers 

(default:  NONE) 

AB  -  one  or  more  additional  libraries  to  be 
searched  for  decks 

ED  -  number  of  levels  of  COPY  and  COPYC 

directives  to  process  -  those  beyond  are 
not  expanded  (just  copied) 

(default:  all  are  expanded) 

DO  -  display  options 


ab 

option 

meaning 

B 

BRIEF 

decks  and  library  origins  not 
listed 

F 

FULL 

library  origin  listed  if  more 
than  one  library  used 

(default:  BRIEF) 

EXPLAIN  Open  an  on-line  manual. 

Syntax:  EXPLAIN  -or- 

EXP 


S  or  SUB JECT=name 
M  or  MANUAL=file 
L  or  LIST=file 
ED  or  EXPAND_DEPTH= integer 

STATUS=status  variable 


90/09/30 


RevO 


Page  H-95 


Parameters:  S  -  search  string 

(default:  the  main  menu  for  a  CONTEXT 

manual  and  the  table  of  contents 
for  a  Topics  manual) 

M  -  the  on-line  manual  to  be  displayed 

(for  a  list  of  CDC_provided  manuals,  see 
catalog  $SYSTEM. MANUALS) 

L  -  (default:  MANUAL_PAGES  in  your  working 
catalog) 

ED  -  the  number  of  the  highest  level  of  topics  t 
be  displayed  initially 
(default:  1;  range:  1  to  10) 

Similar  commands:  NOS:  EXPLAIN 

VMS:  HELP 

Examples:  /explain 

/exp  /m=fortran 
/exp  'getl'  scl 


EXPLAIN_MESSAGE 

Request  a  description  of  a  system  message. 

Syntax:  EXPLAIN_MESSAGE  -or- 

EXPM 


C  or  CONDITION=integer 
ID  or  I  or  IDENTIFIER=s tr ing 
STATUS=status  variable 
CLV$PREVIOUS_STATUS=s tatus 

Parameters:  C  -  condition  code 

(default:  the  code  for  the  last  response 

message  you  received  —  if  normal 
the  first  page  of  the  on-line 
manual  is  displayed) 

ID  -  two-character  product  identifier 

CLV$PREVIOUS_STATUS  -  reserved 

Examples:  /expm 
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EXTRACT_SOURCE_LIBRARY 

Extract  decks  from  a  base  library  to  use  as  a  separate 
library. 


Syntax:  EXTRACT_SOURCE_LIBRaRY  -or- 

EXTSL 


D 

or 

DECKS  or  DECK=keyword  or 
list  of:  name  or  range  of  name 

req  -> 

I 

or 

INTERLOCK=boolean  or  keyword  or 

SC 

or 

SELECTION  CRITERIA=file 

B 

or 

BASE=f ile 

req  -> 

R 

or 

RESULT=f i 1 e 

STATUS=s tatus  variable 


Parameters:  D  -  decks  to  be  copied 

ALL  -  all  decks 

(default:  from  the  criteria  file) 

'  I  -  name  of  the  user  reserving  the  extracted 

decks  -  written  into  the  subinterlock  field 
for  each  extracted  deck  and  in  the  original 
interlock  field  of  each  deck  in  the 
extracted  library 
NONE  -  no  interlock 
FALSE  -  no  interlock 

SC  -  file  from  which  selection  criteria  records 
are  read 

(default:  decks  are  selected  using  the  DECK 
parameter) 


B  -  the  source  library 

(default:  SOURCE  LIBRARY) 


R  -  the  new  source  library 

Similar  commands:  COS,  NOS:  UPDATE 

VMS:  LIBRARY 


Examples : 


/extsl  d= (dkl , dk4 . . dk6)  .. 
../i=false  b=oldpl  r=newlib 
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FICHE  (DTRC)  Print  a  NOS/VE  file  on  microfiche  (COM). 

Syntax:  FICHE 

F  or  FILE=f i 1 e 
T  or  TITLE=string 

J  or  JOB=keyword 
S  or  SHIFT=integer 
H  or  HDR  or  HEADER=file 

STATUS=s tatus  variable 

Parameters:  F  -  the  file  to  be  printed  on  microfiche 

T  -  the  eye-readable  title,  that  is,  the  text  to 
to  be  printed  in  large  letters  across  the  top 
of  the  microfiche  (1~32  characters) 

(must  be  enclosed  in  apostrophes) 

J  “  job  on  microfiche  to  process  the  file 
job  meaning 

COMP  compilation  output  (2  index  frames) 
COMPF  COMP  with  a  box  around  eacft  frame 
COMQ  standard  output  without  index  frames 
COMQF  COMQ  with  a  box  around  each  frame 
COMDA  there  is  a  2-line  eye-readable  title 
in  the  file  specified  by  the  HEADER 
parameter 
,  (Default:  COMQ) 

S  -  specifies  whether  the  file  is  to  be  shifted 
one  column  to  the  right  before  printing 
s  meaning 


0  no  shifting  -  the  file  already  has 

Fortran  carriage  control  characters  in 
column  1  of  each  line 

1  the  file  does  not  have  Fortran  carriage 
control  in  column  1  and  will  be  shifted 
one  column  to  the  right  to  produce  a 
single-spaced  listing 

H  -  file  containing  COM  program  name  and  eye- 

readable  title  records,  such  as  is  needed  by 
COMDA  (the  COM  program  must  have  been  defined 
by  the  Computer  Center  before  it  can  be  used) 
(may  NOT  be  file  $INPUT) 

Remarks:  FICHE  passes  the  parameters  to  the  BEGIN, FICHE 

command  on  NOS.  It  does  this  via  a  NOS/VE  batch 
job  which  it  creates. 

You  can  monitor  the  jobs  with  DISPLAY_JOB_STATUS 
(DISJS) .  When  it  completes,  the  dayfiles  will  be 
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in  files  FICHE_DAYFILE_VE  and  FICHE_DAYFILE_NOS , 
respectively.  If  you  execute  FICHE  more  than 
once,  additional  cycles  of  these  files  will  be 
created. 

Similar  commands:  NOS:  BEGIN, FICHE  (DTRC) 

VMS:  FICHE  (DTRC) 

Examples:  /FICHE, mylist, 'MYPROG  compilation  90/09/16’ 

A —  uses  COMQ  job  and  file  has 
Fortran  carriage  control 

/FICHE  mysorc  'MYPROG  source  listing',,, 1 

A —  uses  COMQ  job  and  shifts  file 
one  column  to  the  right 

/FICHE  myout  'dummy'  comda  0  myout_job 
A —  uses  COMDA  job  and  2- line 
eye-readable  title  in  file 
MYOUT_JOB  (no  shifting) 


FILE_MANAGEMENT_UTILITY 

Execute  the  File  Management  Utility. 

Syntax:  F I LE_MANAGEMENT_UT I L I T Y 

FILMU 
FMU 

I  or  INPUT=file 


O  or  OUTPUT=f i le 

D  or  DIR  or  DIRECTIVE  or  DIRECTIVES=f i 1 e 
L  or  LIST=file 

ED  or  ERROR_DISPOSITION=keyword 
STATUS=status  variable 

Parameters:  I  -  specify  only  if  DIRECTIVES  omitted. 

0  -  specify  only  if  DIRECTIVES  omitted. 

D  -  file  containing  FMU  directives 

L  -  diagnostic  message  and  FMU  summary 

ED  -  controls  termination  if  any  output  error 
ab  option  meaning 


A  ABORT  FMU  aborts 

NA  N0_AB0RT  FMU  continues  writing  other 
files 

(default:  ABORT) 

Remarks:  If  INPUT  and  OUTPUT  are  specified,  FMU  does  a 

simple  copy. 


-or~ 

-or- 
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FOR 


FORMAT 


If  DIRECTIVES  is  specified,  the  directives  give 
the  input  and  output  files  and  the  reformatting 
to  be  done. 

Examples:  /fmu  i=myinfyl  o=myoutfyl 

A —  simple  file  copy 

/fmu  d=mydir 

A —  reformat  data 


Control  repetition  of  a  list  of  statements. 

Syntax:  label:  FOR  EACH  variable  IN  list_expression  DO 

statement  list 
FOREND  label 

-or- 

label:  FOR 

variable=ini tial  TO  final  BY  step  DO 
statement  list 
FOREND  label 

Parameters:  latiel  -  the  name  of  the  FOR  block  -  may  be  used 

by  CYCLE  or  EXIT 

Remarks:  The  limits  are  determined  at  the  start  of  the 

loop,  so  altering  values  of  the  list  expression 
of  the  control  variable,  initial,  final,  or  step 
elements  in  the  statement  list  has  no  effect  on 
the  FOR/FOREND  operation. 

If  INITIAL  =  FINAL  or  STEP  =  0,  the  statement 
list  is  executed  once. 


SCL_PROCEDURE 

Format  a  file  of  SCL  commands  to  improve  readability. 


Syntax: 


FORMAT 

SCL  PROCEDURE 

-or- 

FORMAT 

SCL  PROC 

-or- 

FORMAT 

SCL  PROCEDURES 

-or- 

FORMAT 

SCL  PROCS 

-or- 

FORSCLP 

-or- 

FORSP 

I 

or  INPUT=f i 1 e 

0 

or  OUTPUT=f ile 

PW 

or  PAGE_WIDTH= 

intege 

1IC  or  INITIAL  INDENT_COLUMN= integer 
KC  or  KEY_CHARACTER=string 
UDF  or  UTILITY_DEFINITION_FILE=f i le 
PCT  or  PROCESS_COLLECT_TEXT=boolean 
T  or  TRANSLATE=bool ean  < —  not  at  DTRC 

STATUS=status  variable 
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FORTRAN 


Parameters:  I  -  must  have  the  following  file  attribute 

values : 

ATTRIBUTE  values 


FILE_CONTENTS  LEGIBLE  or  UNKNOWN 
FILE_PROCESSOR  SCL  or  UNKNOWN 
FILE_STRUCTURE  DATA  or  UNKNOWN 

0  -  must  has  the  same  attributes  as  I 

PW  -  must  be  >=  IIC  +  64 
(default:  110) 

IIC  ~  starting  column  of  the  first  output  line 
(default:  1) 

KC  -  this  character  in  column  1  of  a  line 
inhibits  reformatting  of  the  line 
(default:  *) 

UDF  -  file  listing  the  commands  that  start  and 

end  command  utilities  -  if  you  create  your 
own  utilities,  you  need  to  create  a  file 
that  lists  all  the  command  utilities  used 
in  the  procedure 

(default:  only  system-defined  utility 
names  and  terminators  are 
included  in  the  formatted  output) 
PCT  -  TRUE  =>  lines  within  COLLECT_TEXT  and 
similar  commands  are  to  be 
formatted 

FALSE  =>  these  lines  are  not  formatted 
(default:  FALSE) 


Examples:  /forsp  prod  proclp 


Compile  a  Fortran  program. 

Syntax:  FORTRAN  -or" 

FTN 


I 

or 

B 

or 

L 

or 

CD 

or 

DA 

or 

DC 

or 

E 

or 

EL 

or 

EE 

or 

FS 

or 

ISM 

or 

INPUT=f ile 

BINARY  or  BO  or  BINARY_0B JECT=f ile 
LIST=f  ile 

COMPILATION_DIRECTIVES=boolean 
DEBUG_AIDS= 1 i s t  of  keyword 
DEF AU  L  T_COMP I LAT 1 0N=  k  ey wo  r  d 
ERR0R=f i 1 e 
ERROR_LEVEL= key word 
EXPRESSION_EVALUATION=keyword  or 

list  of  keyword 

F0RCED_SAVE=bool ean 
INPUT  SOURCE  MAP=f i 1 e 
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Parameters : 


LO 

or 

MD 

or 

OTD 

or 

OL 

or 

00 

or 

RC 

or 

SL 

or 

SD 

or 

TEL 

or 

TM 

or 

LIST_OPTION  or 

LIST_OPTIONS=keyword  or  list  of  keyword 
MACHINE_DEPENDENT=keyword 
ONE_TRIP_DO=boo lean 

0PTIMIZAT10N_LEVEL  or  OPTIMIZATION  or 
OPT=keyword 

OPTIMIZATION_OPTIONS=keyword  of 

list  of  keyword 
RUNTIME_CHECKS=keyword  or 

list  of  keyword 
SEQUENCED_LINES=bool ean 
STANDARDS_DIAGNOSTICS=keyword 
TERMINATION_ERROR_LEVEL=keyword 
TARGET_MAINFRAME=keyword  < —  not  at  DTRC 
STATUS=status  variable 


L  -  (default:  batch:  $LIST;  interactive:  $NULL) 

CD  -  ON  -  process  C$  directives 

OFF  -  do  not  process  C$  directives 
(default:  ON) 


DA 


debugging  options 
option  meaning 


NONE  no  debugging  options 

ALL  all  debugging  options  (DT  and  PC) 

DT  generate  line  number  and  symbol 

tables 

PC  generate  argument  checking 

information  in  the  object  code 
(default:  NONE) 

DC  -  character  weight  table  (collating  sequence) 
for  character  expressions,  CHAR,  ICHAR 


ab 

option 

meaning 

u 

USER 

user-speciL ied  weight  table 

(DISPLAY) 

F 

FIXED 

fixed  weight  table  (ASCII) 

(default:  FIXED) 

EL  -  (I,  W,  F,  C) 

(default:  WARNING) 

EE  -  controls  compiler  expression  evaluation 
ab  option  and  meaning 


C  CANONICAL 

expressions  are  evaluated  according 
to  precedence  rules 
ME  MAINTAIN_EXCEPTIONS 

don't  eliminate  of  instructions 
which  might  cause  run-time  errors 
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MP  MAINTAIN_PRECISIC.\ 

don't  change  floating-point 
operations  to  a  mathematically 
equivalent  form 

OSM  OVERLAPP ING_STRINGS_MOVES 

character  assignment  v=exp  may  have 
same  positions  in  v  and  exp 
R  REFERENCE 

call  intrinsic  functions  by 
reference  to  get  Fortran-generated 
error  messages  instead  of  system¬ 
generated  messages 

(default:  NONE;  multiple:  (op,..., op)) 

FS  -  ON  -  variables  and  arrays  in  subprograms 
retain  values  are  saved  on  RETURN  or 
END  (same  as  SAVE  in  every  subprogram) 
OFF  -  not  saved 
(default:  OFF) 

ISM  -  file  with  the  source  map  generated  by  the 
OUTPUT_SOURCE_MAP  option  of  the  SCU 
EXPAND_DECK  command 
(default:  $NULL) 

LO  -  compiler  output  listing  options 
lo  meaning 


A  list  symbolic  name  attributes 

R  cross  reference  listing 

M  A  +  DO  loop  and  common  block  maps 

S  list  source  program 

SA  S  +  list  lines  turned  off  by  C$  LIST 

0  object  code  listing  (do  not  use  at 

DTRC  unless  requested  by  User 
Services) 

NONE  no  output  listing 
(default  :  S;  multiple:  (op,...,op)) 

MD  -  controls  diagnosis  of  machine-dependent 
capabi  1 i t i es 

ab  option  meaning 

NONE 

I  INFORMATIONAL 

W  WARNING 
F  FATAL 
(default:  NONE) 

OTD  -  ON  -  DO  loops  executed  at  least  once 

OFF  -  DO  loops  executed  at  least  zero  times 
(default:  OFF) 


do  not  diagnose  machine 

dependencies 

treat  as  informational 

errors 

treat  as  warning  errors 
treat  as  fatal  errors 
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OL  -  (OPT)  controls  optimization 


option 

meaning 

HIGH 

slow  compile,  fast 

execution 

LOW 

fast  compile,  slow 

execut i on 

DEBUG 

stylized  for  debugging 

(defaul t : 

LOW) 

not  used 

at  DTRC 

SL  -  ON  -  source  program  is  in  sequenced  format 
OFF  -  source  program  is  in  nonsequenced 
format 

SD  -  controls  non-ANSI  diagnosis 

ab  option  meaning 


NONE  do  not  flag  nonstandard 

usages 

I  INFORMATIONAL  treat  as  informational 

errors 

W  WARNING  treat  as  warning  errors 

F  FATAL  treat  as  fatal  errors 

(default:  NONE) 

TEL  -  minimum  severity  level  for  returning 
abnormal  status  (I,  W,  F,  C) 

Similar  commands:  COS:  CFT;  CFT77;  CF77 

NOS:  FTN,  FTN5 
VMS:  FORTRAN 

Examples:  /fortran  i=my_source  lo=(s,m,r) 

FUNCTION 

First  statement  of  an  SCL  function  defining  the  function's 
names,  attributes,  and  parameters. 

Syntax:  FUNCTION  (attributes)  function_names  ( 

parameter  definition 

) 

statement  list 
FUNCEND  f unct i on_name 

Parameters:  attributes  -  any  of: 

.  the  name  of  a  help  module 
.  XDCL  -  the  function  can  be 
called  from  outside 
its  object  library 
and  by  commands 
within  that  library 
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.  ADVANCED  -  the  function  is  not 
listed  by  DISCLE 
uniess  requested  by 
the  DO  parameter 

.  HIDDEN  -  the  function  is  not 
listed  by  DISCLE 

func_names  -  the  function  name  and  its  aliases: 
name,  alias,  ...,  alias 
(must  begin  with  $) 

param_defs  -  define  the  function  parameter: 

parameter_name  :  (attributes)  type 
expression  =  default 

Remarks:  Function_name  is  optional  on  the  FUNCEND 

statement  —  if  used,  it  must  be  the  first 
function  name: 

function  di splay_number ,  di splay_numbers ,  .. 
disn 

•  •  • 

FUNCEND  di splay_number 

The  statement  list  may  not  contain  PROCEDURE/ 
FROCEND  or  another  FUNCTION/ FUNCEND . 

An  SCL  function  constitutes  its  own  block. 

A  function  must  reside  in  an  object  library. 

Functions  cannot  have  attributes  VAR  or  SECUDE. 

When  called,  parameters  are  specified 
positionally,  and,  therefore,  cannot  have  the 
BY_NAME  attribute. 

Similar  commands:  VMS:  .COM  file  to  define  global  variable 

FUNCTION 

(UTILITY  subcommand)  Declare  an  entry  in  a  utility  function 
table. 

Syntax:  FUNCTION 

N  or  NAMES  or  NAME=data_name  or 

list  of  data  name 


P  or  PR0CESS0R=name 
A  or  AVAILABILITY=keyword 

Parameters:  N  -  the  name  of  the  function 

P  -  the  name  of  the  processor  for  the  function 
(default:  the  first  name  of  the  function  is 
the  name  of  the  processor) 
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A  -  (attribute:  BY_NAME) 

specify  whether  the  function  appears  in  a 
command  list  entry  display 
ab  option  meaning 


NU  NORMAL_USAGE  function  appears  in  a 

command  list  entry 
display 

AU  ADVANCED_USAGE  it  does  not  appear 

unless  you  specifically 
request  it 

H  HIDDEN  it  does  not  appear 

(default:  NORMAL  USAGE) 


GENER ATE_COMMAND_TAB  LE 

Generate  command  and  function  tables  for  a  command  environment. 


Syntax:  GENERATE_COMMAND_TABLE  -or- 

GENCT 

I  or  INPUT=f ile 
0  or  OUTPUT=file 


PW  or  PAGE_WIDTH= integer 

STATUS=status  variable 

Parameters:  I  -  the  file  with  the  command  table  declaration 

0  -  the  file  to  receive  the  CYBIL  representation 
of  the  command  table 

PW  -  the  output  file  page  width  (31.. 110) 
(default:  output  file's  page  width 

attribute  forced  to  be  in  31. .110 


GENERATE_SCU_EDIT_COMMANDS 

Compare  a  deck  and  a  text  source  file  and  generate  editing 
commands  to  make  the  deck  match  the  source  file. 

Syntax:  GENERATE_SCU_EDIT_COMMANDS  -or- 

GENSEC 

D  or  DECK=keyword  or  name 
S  or  S0URCE=f i le 
EC  or  EDIT  COMrtANDS=f i le 


B  or  BASE=file 

TD  or  TERMINATING_DELIMITER=s t ring 
LSS  or  LEADING_SPACES_SIGNIFICANT=boolean 
STATUS=status  variable 
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Parameters:  D 

S 

EC 


the  deck  to  which  the  generated  editing 
subcommands  apply 

ALL  -  the  source  file  is  to  include  the 
*DECK  directives 

file  with  a  modified  version  of  the  deck 

the  file  to  receive  the  editing  commands 
and  text 


B  -  the  source  library  where  the  deck  resides 
(default:  SOURCE_LIBRARY) 

TD  -  characters  that  mark  the  end  of  inserted 
text  in  the  editor  commands  file 
(default:  ///END\\\) 

LSS  -  TRUE  =>  leading  blanks  are  significant 

FALSE  =>  leading  blanks  are  not  significant 


Remarks:  The  source  file  text  must  not  contain  line 

identifiers . 


The  source  file  text  must  not  contain  DECK 
directives  unless  DECK=ALL  is  used. 


If  it  doesn't  matter  how  many  blanks  precede  the 
text  in  a  line,  specify  LSS=TRUE  to  inhibit 
generation  of  editing  commands  whose  sole  purpose 
is  to  change  the  number  of  leading  blanks. 


GETJFILE 

Copy  a  NOS  file  to  NOS/VE. 


Syntax: 


GET_FILE  -or- 
GETF 

T  or  T0=f i le 


F  or  FR0M=name  or  string 
DC  or  DATA_CONVERSION=keyword 
U  or  ID  or  USER=name  or  string 
PW  or  PASSSWORDS  or  PASSWORDS i st  of  name 
C  or  CY  or  CYCLE=integer  < —  not  at  DTRC 

STATUS=status  variable 


Parameters:  T 


the  NOS/VE  file  (may  be  positioned) 


F  -  the  NOS  file 

(an  SCL  name  or  1-  to  31-character  string) 
(default:  the  file  name  component  of  TO) 
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DC  -  type  of  conversion  to  be  done 
dc  meaning 


B60  60-bit  NOS  word  placed  into  rightmost 
bits  of  NOS/VE  word  with  leftmost  4 
bits  set  to  0  (zero) 

B56  rightmost  56  bits  of  NOS  words  are 
packed  into  contiguous  NOS/VE  bits 
ignoring  the  leftmost  4  NOS  bits 
A6  6/12  NOS  display  code  converted  to 
ASCII 

A8  12-bit  NOS  ASCII  converted  to  7-bit 
ASCII 

D63  6-bit  NOS  display  code  (63-character 
set)  converted  to  7-bit  ASCII 
D64  6-bit  NOS  display  code  (64-character 
set)  converted  to  7-bit  ASCII 
(default:  A6) 

U  -  alternate  NOS  user 

PW  -  (attribute:  SECURE) 

NOS  password  required  to  access  the  file 

Remarks:  SET_FILE_ATTRIBUTE  may  precede  the  GET_FILE  to 

establish  attribute  values  to  be  preserved. 

The  NOS  file  must  not  be  on  a  cartridge. 

CHANGE_LINK_ATTRIBTUE  prior  to  GETF  identifies 
the  accounting  and  user  information  for  accessing 
the  file. 

DC=D64,  A6,  or  A8,  requires  zero-byte  terminated 
(Z-type)  NOS  records. 

Embedded  NOS  EORs  are  eliminated  from  the  NOS/VE 
copy  of  the  file. 

See  also:  MSFETCH;  MSSTORE;  REPLACE_FILE 

Similar  commands:  NOS:  FCOPY 

VMS:  HFT  FETCH  (DTRC) ;  FTP 

Examples:  /getf  ve_file  nosfile 


Page  H-108 


RevO 


90/09/30 


GET_LINE 

Read  a  line  from  a  file 


into  a  string  variable. 


Syntax:  GET_LINE  -or- 

GET_LINES  -or- 
GETL  -or- 
ACCEPT_LINE  -or- 
ACCEPT_LINES  -or- 
ACCL 

V  or  VARIABLE=str ing  variable  or 

array  of  string  variables 
I  or  INPUT=f i 1 e 


P  or  PROMPT=string 
LC  or  LINE_COUNT=integer  variable 
STATUS=s tatus  variable 


Parameters:  V 


the  variable  into  which  lines  are  read 


I  -  the  file  to  be  read 


P  -  the  input  prompt  string 

(if  I  is  not  assigned  to  a  terminal,  there 
is  no  prompting) 

(default:  ENTER  <variable  name>) 


LC  - 


will  contain  the  number  of  lines  read 
GETL 


by 


Remarks:  Don't  use  standard  files  such  as  $INPUT. 


Similar  commands:  VMS:  READ 

Examples:  PROCEDURE  write_to_list  ( 

input,  i:  file  =  Srequired 
status) 

VAR 

input_list:  list  of  string 
VAREND 

get_line  v=input_list  i=input  p= ' ?  ' 
display_value  input_list 
PROCEND  write_to_l ist 

/write_to_lst  i=input 
?  123 
?  456 

?  789 

?  *EOI 
123 
456 
789 


< —  input  is  the  job  file 
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HELP  Open  an  on-line  manual. 

Syntax:  HELP  -or- 

H 


S  or  SUB JECT=data_name  or  string  or 
application 
M  or  HANUAL=file 
L  or  LIST=f ile 

STATUS=status  variable 

Parameters:  S  -  the  index  topic  to  be  searched 

(enclose  in  apostrophes  if  any  embedded 
blanks) 

(default:  main  menu  (CONTEXT  manual)  or 

table  of  contents  (Topics  manual)) 

M  -  the  on-line  manual  to  be  displayed 

(default:  SCL  (Commands  and  Functions); 

if  in  a  utility  with  an  on-line 
manual,  that  manual  is  displayed) 

L  -  the  file  to  receive  the  listable  output 
(default:  MANUAL_PAGES) 

Remarks:  HELP  without  parameters: 

.  if  after  an  error,  the  NOS/VE  Diagnostic 
Messages  manual  (file  name  MESSAGES) 

.  with  a  utility,  the  utility's  on-line  manual 
or  the  utility  description  in  the  NOS/VE 
Commands  and  Functions  manual 
.  neither  of  the  above,  the  table  of  contents 
of  the  NOS/VE  Commands  and  Functions  manual 

Similar  commands:  NOS:  EXPLAIN;  HELPME 

VMS:  HELP 

Examples:  /help  m=fortran 

A —  the  on-line  Fortran  manual 

/help  fortran 

A —  the  NOS/VE  Commands  and 

Functions  manual  searching  for 
FORTRAN 

/help  Squote 

A —  display  the  description  of  the 
SQUOTE  function 

/ f tn= ' get_l ine ' 

/help  s=ftn 

A —  search  for  FTN 

(FTN  not  evaluated) 

/explain  s=ftn  m=scl 

A —  search  for  GET_LINE 
(FTN  evaluated) 
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/HELP  CCRM  .NSYS.CCRM 

A —  the  on-line  Computer  Center 
Reference  Manual 


IF  Conditional  execution  of  one  or  more  statement  lists. 

Syntax:  IF  boolean  expression  THEN 

statement  list 

ELSEIF  boolean  expression  THEN 
statement  list 
ELSE 

statement  list 
I  FEND 

Parameters:  boolean  expression  -  TRUE  =>  execute  the 

following  statement 
list 

Command  prompt:  IF/ 

Similar  commands:  COS:  IF-ELSEIF-EXITIF-ENDIF 

NOS:  IF 

VMS:  IF-THEN-ELSEIF-ENDIF 


INCLUDE_COMMAND 

Include  a  string  containing  SCL  statements  into  the  command 
stream. 

Syntax:  INCLUDE_COMMAND  -or- 

INCC 

C  or  C0MMAND=  string 


EE  or  ENABLE_ECHO  or  ENABLE_ECHOING=boolean 
STATUS^status  variable 

Parameters:  C  -  string  of  semicolon-separated  statements 

EE  -  TRUE  =>  echo  the  command 

FALSE  =>  do  not  echo  the  command 
(default:  TRUE) 

See  also:  INCLUDE  FILE;  INCLUDE_LINE 
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INCLUDE 


INCLUDE 


FILE 

Insert  a  text  file  of  SCL  commands  into  the  command  stream. 

Syntax:  INCLUDE_FILE  -or- 

INCF 

F  or  FILE=file 


P  or  PROMPT=string 
U  or  UTILITY=keyword  or  name 
STATUS=status  variable 

Parameters:  P  -  the  input  prompt  string  if  F  is  assigned  to 
an  interactive  terminal 

(if  U  is  specified,  the  utility's  prompt  is 
used) 

(default:  incf) 

U  -  the  utility  to  be  associated  with  INCF 
(U  is  intended  for  use  within  UTILITY/ 
UTILITYEND  providing  a  mechanism  for 
associating  QUIT  commands  entered 
interactively  with  the  specified  utility 
block) 

NONE  -  use  to  avoid  association  with  a 
utility 
(default:  NONE) 

Similar  commands:  VMS:  @ 

Examples:  /incf  commands 


LINE 

Insert  a  string  containing  SCL  statements  into  the  command 
stream. 

Syntax:  INCLUDE_LINE  -or- 

INCL 

SL  or  STATEMENT_LIST=s tring 


EE  or  ENABLE_ECHO  or  ENABLE_ECHOING=boolean 
U  or  UTILITY=keyword  or  name 
STATUS=status  variable 

Parameters:  SL  -  the  string  of  semicolon-separated  statements 

to  be  processed  as  a  statement  list 

EE  -  TRUE  =>  echo  the  command 

FALSE  =>  do  not  echo  the  command 
(default:  TRUE) 

U  -  the  utility  to  be  associate-  with  INCL 
(U  is  intended  for  use  within  UITLITY/ 
UTILITYEND  providing  a  mechanism  for 
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associating  QUIT  commands  entered 
interactively  with  the  specified  utility 
block) 

NONE  -  use  to  avoid  association  with  a 
utility 
(default:  NONE) 

Examples:  /tim  =  ' $t ime (ampm) ' 

/dat  =  ' $date (month) ' 

/command_list  =  . . 

. ./ ' display_vaule  ('  //  tim  // 

../'  //  dat  //  ')' 

/include_line  command_list 
10:59  AM 

January  24,  1990 


INITIALIZE_TERMINAL 

Change  the  terminal  settings. 

Syntax:  INITIALIZE_TERMINAL  -or- 

INIT 


STATUS=status  variable 

Parameters : 

Remarks:  For  INIT  to  change  the  terminal  settings,  the 

terminal  definition  must  contain  at  least  two 
APPLICATION_STRING  statements  of  the  format: 
APPLICATION_STRING  NAME= ' LINE_INIT '  .. 
OUT='cext  sent  to  terminal' 

APP L I CAT 1 0N_S TR I NG  NAME= ' SCREEN_INIT '  .. 
0UT='text  sent  to  terminal' 

where  you  supply  the  text  strings. 


JOB 


Generate  and  submit  a  batch  job. 
Syntax:  JOB 


UJN  or  USER_JOB_NAME  or  JN  or  J OB_NAME=nam e 

CTL  or  CPU_TIME_LIMIT=keyword  or  integer 

ERT  or  EARLIEST_RUN_TIME=date_t ime 

JAD  or  JOB_ABORT_DISPOSITION=keyword 

JC  or  J0B_CLASS=name 

JDBU  or  JOB_DEFERRED_BY_USER=boolean 

JER  or  JOB_EXECUTION_RING= integer 

JQ  or  JOB_QUALIFIERS  or 

JOB_QUALIFIER=keyword  or  list  of  name 
JRD  or  JOB_RECOVERY_DISPOSITION= keyword 

LRT  or  LATEST  RUN  TIME=date  time 
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Parameters : 


MAXWS  or  MAXIMUM_WORKING_SET=keyword  or  integer 

OF  or  OPERATOR_FAMI L Y=name 

OU  or  OPERATOR_USER=name 

OD  or  OUTPUT_DISPOSITION=keyword  or  file 

SL  or  SRU_LIMIT=keyword  or  integer 

S  or  STATION=keyword  or  name 

SM  or  SUBSTITUTION_MARK=keyword  or  string 

UI  or  USER_INFORMATION=string 

SJN  or  SYSTEM_JOB_NAME=name  variable  or 

string 

STATUS=status  variable 


CTL  -  maximum  CPU  time  for  the  job 

(job  abort  limit  if  job  plus  monitor  time 
exceeds  this  value) 

ctl  meaning 


integer  maximum  CPU  seconds 

SYSTEM_DEFAULT  system  default  used 
UNLIMITED  maximum  allowed  by  the 

system 

(default:  explicit  JC:  minimum  of  class' 

TL  or  user's 
validation  TL 

CJ=AUTOMATIC:  minimum  of  system 
default  TL  or 
user ' s 

validation  TL) 

ERT  -  earliest  time  to  execute  -or- 
NONE  -  job  may  run  anytime 
(default:  NONE) 

JAD  -  action  if  job  aborts  because  of  system 
failure 

jad  meaning 


RESTART  resubmit  job  to  start  at 
beginning 

TERMINATE  discard  the  job 

JC  -  the  job  class 

jc  meaning 


AUTOMATIC  automatically  assign  to  job 
class  depending  on  job's 
attributes 

-  TRUE  =>  job  is  deferred  (held  in  input 
queue  indefinitely) 

FALSE  =>  job  is  not  deferred 
(default:  JDBU  job  attribute  used) 


JDBU 
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JER 


J  Q 


JRD 


LRT 


MTL 


MAXWS 


the  job's  execution  ring 
(range:  4-13,  must  be  at  least  at  great 
as  your  minimum  ring 
val idat ion) 

site-defined  qualifiers  for  limiting  a 
job  to  a  specific  job  class  or  set  of 
classes 

jq  meaning 


1~5  qualifiers  restrict  the  job 
NONE  no  job  qualifiers 

SYSTEM_DEFAULT  use  the  system  default 
value 

action  if  job  aborts  because  of  system 
interrupt 

jrd  meaning 


CONTINUE  attempt  to  resume  the  job  - 
if  not  successful,  use  JAD 
RESTART  resubmit  job  to  start  at 
beginning 

TERMINATE  discard  the  job 

latest  time  to  execute  (if  not  executed, 
job  is  dropped)  -or- 
NONE  -  job  may  run  anytime 
(default:  NONE) 

maximum  number  of  tape  drives  used 
simultaneously 

mtl  meaning 


integer  1~2 

SYSTEM_DEFAULT  system  default  used 
UNLIMITED  maximum  allowed  by  the 

system 

(default:  system  default  is  used) 


-  the  maximum  number  of  pages  the  job 

requires  (may  be  restricted  by  job  class) 
maxws  meaning 


integer 

SYSTEM_DE FAULT  system  default  used 
UNLIMITED  maximum  allowed  by  the 

system 

(default:  determined  by  job  class) 


OF 

OU 
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ODI  -  the  disposition  of  standard  output 


ab 

odi 

DAO 

DISCARD  ALL  OUTPUT 

DSO 

DISCARD  STANDARD  OUTPUT 

P 

PRINTER 

WQ  WAIT_QUEUE  (output 

user's 

(default:  PRINTER) 

goes  into 
$WAIT_QUL 

SL  -  maximum  SRUs  for  the  job 

(job  abort  limit  if  this  is  exceeded) 
si  meaning 


integer  maximum  SRUs 

SYSTEM_DEFAULT  system  default  used 
UNLIMITED  maximum  allowed  by  the 

system 

(default:  explicit  JC:  minimum  of  class' 

SL  or  user's 
validation  SL 

CJ=AUTOMATIC:  minimum  of  system 
default  SL  or 
user's 

validation  SL) 

S  -  the  default  I/O  station  name  for  the 

job's  output  files 

(if  JOB_DESTINATI 0N_U SAGE  is  PRIVATE, 
this  must  specify  te  control  facility 
name) 

AUTOMATIC  -  use  the  system  default 

SM  -  (substitution  marks  cannot  be  used  to 

generate  the  JOBEND  statement) 

UI  -  up  to  256  characters  to  be  passed  to  the 
job  and  to  all  generated  output  files 
(default:  the  UI  associated  with  the  job) 

Remarks:  JOB  is  followed  by  SCL  statements  ending  with 

JOBEND. 

LOGIN  and  LOGOUT  are  added  to  your  job  by  the 
system. 

Command  prompt:  job/ 

See  also:  LOGIN;  SUBMIT_JOB 

/JOB  AMDS001  15 
job/<SCL  statements> 
job/ JOBEND 


Examples : 
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KERMIT  Begin  a  KERMIT  file  transfer  session. 
Syntax:  KERMIT 


T  or  TAKE=file 

STATUS=s tatus  variable 

Parameters:  T  -  reserved 

See  also:  XMODEM_RECEI VE ;  XMODEM_SEND;  YMODEM_RECEIVE; 

YMODEM_SEND 

Similar  commands:  NOS:  FTP;  KERMIT-170;  XMODEM 

VMS:  FTP;  KERMIT 

Examples:  /kermit 


LOGIN  Provide  access  to  NOS/VE  batch  services. 

Syntax:  LOGIN 

LU  or  LOGIN_USER  or  U  or  USER=name 

PW  or  PASSWORD=name 


LF  or  LOGIN_FAMILY=name 

LA  or  LOGIN_ACCOUNT=name 

LP  or  LOGIN_PROJECT=name 

CTL  or  CPU_TIME_LIMIT=keyword  or  integer 

ERT  or  EARLIEST_RUN_TIME=dat e_t ime 

JAD  or  JOB_ABORT_DISPOSITION=keyword 

JC  or  JOB_CLASS=name 

JDBU  or  JOB_DEFERRED_BY_USER=boolean 

JER  or  JOB_EXECUTION_RING= integer 

JQ  or  JOB_QUALIFIERS  or 

JOB_QUALIFIER=keyword  or  list  of  name 
JRD  or  JOB_RECOVERY_DISPOSITION=keyword 

LRT  or  LATEST_RUN_TIME=date_t ime 

MTL  or  MAGNETIC_TAPE_LIMIT=keyword  or  integer 

MAXWS  or  MAXIMUM_WORKING_SET=keyword  or  integer 

SL  or  SRU_LIMIT=keyword  or  integer 

UI  or  USER_INFORMATION=string 

UJN  or  USER_J0B_NAME  or  JN  or  JOB_NAME=name 

Parameters:  See  JOB 

Remarks:  ERT,  LRT,  JDBU  are  ignored  for  interactive  jobs. 

See  also:  SUBMIT_JOB 

Similar  commands:  NOS:  LOGIN;  HELLO 


Examp  1 es : 


/login  amds  my_password 
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LOGOUT 


LOOP 


MANAGE 


Terminate  a  batch  or  interactive  job. 
Syntax:  LOGOUT 

See  also:  LOGIN;  JOB;  SUBMIT_JOB 

Similar  commands:  NOS,  VMS:  LOGOUT 
Examples:  /logout 


Repeat 

Syntax 


forever  a  statement  list. 

label:  LOOP 

statement  list 
LOOPEND  label 


Parameters:  label  -  the  name  of  the  LOOP  block  -  may  be  used 

by  CYCLE  or  EXIT 

Remarks:  LOOP  may  be  exited  only  by  an  EXIT  statement. 

Similar  commands:  VMS:  WHILE  TRUE  DO 


FORM 

Begin  a  MANAGE_FORMS  utility  session. 

Syntax:  MANAGE_FORM  -'r- 

MANAGE_FORMS  -or~ 

MANF 


VC  or  VARIABLE_CREATION=keyword 
VE  or  VARIABLE_EVALUATION=keyword 
STATUS=status  variable 


Parameters:  VC  -  controls  creation  of  variables  when  a  form 

is  opened. 

vc  meaning 


FORM_VARIABLE  create  one  variable  for  each 
form 

SINGLE  create  one  variable  for  each 

variable  on  the  form 
NONE  create  no  variables 

(default:  FORM  VARIABLE) 


VE  -  controls  how  the  utility  evalutates 
variables 

ve  meaning 


AUTOMATIC  READ_FORMS  or  SH0W_F0RMS  updates 
all  variables 
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MANUAL  you  must  use  GET_FORM_VAR I ABLE 
and  REPLACE_FORM_VARIABLE 
subcommands  to  update  them 

Subcommand  prompt:  mf/ 


MANAGE_JOB 

Begin  a  utility  that  manages  the  selection  and  control  of  one 
or  more  jobs. 

Syntax:  MANAGE_JOB  -or- 

MANAGE_JOBS  -or~ 

MANJ 

STATUS=s tatus  variable 


MANAGE_OUTPUT 

Begin  a  utility  that  manages  the  selection  and  control  of  one 
or  more  output  files. 

Syntax:  MANAGE_0UTPUT  -or- 

MANAGE_OUTPUTS  -or~ 

MANO 


STATUS=status  variable 


MEASURE_PROGRAM_EXECUTION 

Begin  a  program  measurement  utility  session. 

Syntax:  MEASURE_PROGR AM_EXECUT I ON  -or- 

MEAPE 


STATUS=s tatus  variable 

Subcommand  prompt:  MPE/ 

Similar  commands:  COS:  SPY 

NOS:  HOTSPOT 
VMS:  PCA 

Examples:  /meape 

MPE/set_program_descr ipt i on  targe t_text=lgo 
MPE/ execute_ins  t rumen ted_t ask 
MPE/di splay_program_prof i le  output=my_f i le 
MPE/quit 
/ 
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MERGE  Merge  sorted  records  from  one  or  more  files  and  write  them 
in  sorted  order  to  a  single  output  file. 

Syntax:  MERGE 


F  or  FR0M=1 is t  of  file 

T  or  TO=f i le 

K  or  KEY=list  of  list  of  range  of  any 

D  or  DIR  or  DIRECTIVES  or 

DIRECTIVES_FILE  or  DF=list  of  file 
L  or  LIST=f i le 

L0  or  LIST_0PTI0N  or 

LIST_0PTI0NS=1 ist  of  keyword 
E  or  ERR0R=f i 1 e 

EL  or  ERROR_LEVEL=keyword 

RP9  or  RESERVED_P0SITI0N_9=boolean 

ENR  or  ESTIMATED_NUMBER_RECORDS= range  of 

integer 

ERF  or  EXCEPTION_RECORD_FILE=f i le 

CC  or  C 1 7 0_COMPAT I BLE=  boolean 

OD  or  OMIT_DUPLICATIONS=boolean 

OFL  or  OWNFL  or  OWNCODE_FIXED_LENGTH= integer 
OMRL  or  OWNCODEJMAXIMUM_RECORD_LENGTH= integer 
0P1  or  0WN1  or  OWNCODE_PROCEDURE_l=name 

0P2  or  OWN 2  or  0WNC0DE_PR0CEDURE_2=name 

OP3  or  OWN3  or  0WNC0DE_PR0CEDURE_3=name 

OP4  or  OWN 4  or  0WNC0DE_PR0CEDURE_4=name 

0P5  or  0WN5  or  OWNCODE_PROCEDURE_5=name 

ROO  or  RETAIN_ORIGINAL_ORDER  or  RETAIN  or 
RET=boolean 

CSN  or  COLLATING_SEQUENCE_NAME  or 
SEQN=name 

CSS  or  COLLATING_SEQUENCE_STEP  or 
SEQ=list  of  rangeof  any 
CSR  or  COLLATING_SEQUENCE_REMAINDER  or 
SEQR=boolean 

CSA  or  COLLATING_SEQUENCE_ALTER  or 
SEQA=boolean 
STATUS=status  variable 
S  or  SUM=list  of  list  of  range  of  any 
ZLR  or  ZERO_LENGTH_RECORDS=keyword 
VMIO  or  VERIFY_MERGE_INPUT_ORDER  or 
VERIFY  or  VER=boolean 
LCT  or  LOAD_COLLATING_TABLE=l i st  of  name 
RA  or  RESULT_ARRAY  or  RES=array  of  integer 

variables 

Parameters:  See  SORT. 


Similar  commands:  NOS:  MERGE 
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Examples:  /merge  ($user . infyl 1 , $user . infyl2) 

. . /$user . outfyl 
. . /key= ( (1 , 10) )  verify=yes 

A —  merge  files  infyll  and  infyl2 
producing  infyl3  —  leftmost 
10  characters  are  used  as  the 
key  —  the  sort  is  ascending 
ASCII  —  the  input  record 
sort  order  is  checked 


MSACCES  (DTRC)  Access  the  Mass  Storage  System  (MSS). 

Syntax:  MSACCES 

MPW=name 


STATUS=s tatus  variable 

Parameters:  MPW  -  (Attributes:  SECURE) 

your  MS  access  password 

Remarks:  MSACCES  is  required  before  using  the  MSx  commands. 

Similar  commands:  COS:  MSACCES  (DTRC) 

NOS:  login  process 
VMS:  HFT  ACCESS  (DTRC) 

Examples:  /MSACCES  mymsspw 


MSAUDIT  (DTRC)  Obtain  a  sorted  audit  of  your  MSS  files. 


Syntax:  MSAUDIT 


O  or  0UTPUT=f i le 
L0  or  LIST_OPTION=keyword 
PW  or  SPW  or  SHOW_PW  or  SHOW_PASSWORD  or 
SHOW_PASSWORDS=keyword 
UN  or  USER_NAME=name 
F  or  FILE  or  FILES=list  of  file 
STATUS=s tatus  variable 


Parameters:  LO 


the  list  option 
ab  option 


meaning 


F  FULL  4  lines  per  file  +  cost 

per  day  and  per  month 

I  INTERMEDIATE  SHORT  +  date  created, 

date  last  accessed, 
number  of  streams 
(direct  files) , 
password  (if  requested), 
charge  number  (your 
files),  cost  per  day 
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N  NAMES  7  filenames  per  line 

separated  by  indirect/ 
direct,  files  on 
cartridge  are  flagged 

S  SHORT  length,  filename,  CT, 

M  (permissions) ,  number 
of  uses,  indirect/direct 

(default:  FULL) 

PW  -  indicates  whether  individual  file  passwords 
are  to  be  included  in  the  listing  —  your 
files  only 

pw  meaning 


YES  or  YE  or  Y  list  file  passwords 
NO  or  N  do  not  list  them 

(default:  NO) 

UN  -  alternate  user  name  to  display  another  user's 
files  (only  those  files  you  are  permitted  to 
see) 

(default:  your  own  files) 

F  -  a  single  filename  or  a  filename  with 
wildcards 

(must  be  enclosed  in  apostrophes) 

(default:  all  filenames  are  listed) 

Remarks:  MSACCES  is  required  before  using  the  MSx  commands. 

See  also:  MSFILES 

Similar  commands:  NOS:  CATLIST 

VMS:  HFT  DIRECTORY;  MSSAUDIT  (both  DTRC) 

Examples:  /MSACCES, mymsspw 

A —  required  to  access  MSS 
/MSAUDIT  < —  4  lines  per  file  on  $0UTPUT 

/MSAUDIT,0=audout , L0=I , SPW=Y 

A —  1  line  per  file  (including 

each  file's  password)  written  to 
file  AUDOUT  in  your  current 
catalog 

/MSAUDIT  out  1  s  UN=other 

A—  short  list  of  user  OTHER's  MSS 
files  in  file  OUTl  in  your 
current  catalog 

/MSAUDIT  p= ' v****** ' 

A —  all  files  starting  with  "V" 
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MSCATLIST  (DTRC)  The  NOS  CATLIST  command. 
Syntax:  MSCATLIST 


DN=integer 

EF=string 

FN=string 

L=f ile 

LO=keyword 

NA=keyword 

PN=name 

PW=keyword 

R=name 

UN=name 

WB=keyword 

STATUS=s tatus  variable 

Parameters:  See  Appendix  I:  CATLIST 

See  also:  MSAUDIT 

Similar  commands:  NOS:  CATLIST 

VMS:  HFT  DIRECTORY 


MSCHANG  (DTRC)  Change  the  attributes  of  a  Mass  Storage  System  file. 

Syntax:  MSCHANG 

F  or  FN  or  FILE=name 


NFN  or  NEW_FILE_NAME=name  or  INPUT=file 
PW  or  PASSWORD=name 
CT  or  CATEGORY_TYPE=keyword 
M  or  F I LE_ACCES S_MODE= k eywor d 
BR  or  BACKUP_REQUIREMENTS  or 

BACKUP_REQUIREMENT=keyword 

CP=integer 

STATUS=status  variable 

Parameters:  F  -  the  MSS  file  whose  attributes  are  to  be 

changed 

NFN  -  new  file  name 

(default:  no  change) 

PW,  CT,  M,  BR  -  same  as  MSSTORE 

(default  for  each:  no  change) 

CP  -  controls  changing  the  account  number  for 
the  file 

cp  meaning 


0  do  not  change  the  account  number 
1  change  the  account  number  to  the 
MSACCES  account  number 
(default:  0) 
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Remarks:  MSACCES  is  required  before  using  the  MSx  commands. 

Similar  commands:  COS:  MSCHANG  (DTRC) 

NOS:  CHANGE 

VMS:  HFT  CHANGE  (DTRC) 

Examples:  /MSCHANG  myfile  CT=PU 

A —  make  MYFILE  a  public  file 

/MSCHANG , my f i 1 e , CP= 1 

A —  change  the  account  number 

/MSCHANG  myfile  NFN=newfile  M=E 

A —  change  the  name  of  the  file  and 
make  it  execute-only 

/MSCHANG .myfile, BR=CR 

A —  off-station  backup  at  additional 
cost 


MSFETCH  (DTRC)  Fetch  a  file  from  the  Mass  Storage  System. 

Syntax:  MSFETCH 

F  or  MFN  or  FRQM=name 


T  or  T0=file 

DC  or  DATA_CONVERSION=keyword 
U  or  USER  or  UN  or  JD=name 
PW  or  PASSWORD  or  PASSWORDS=l ist  of  name 
STATUS=status  variable 

Parameters:  F  -  the  MSS  file  to  be  fetched 

T  -  the  NOS/VE  name  for  the  file 

DC  -  how  the  file  is  to  be  transferred 
dc  meaning 


B60  NOS  word  — >  rightmost  60  NOS/VE 

bits;  leftmost  4  NOS/VE  bits  set  to  0 
B56  rightmost  56  NOS  bits  — >  contiguous 
NOS/VE  bits;  leftmost  4  NOS  bits 
ignored  (use  for  NOS/VE  object 
libraries,  SCU  libraries,  permanent 
file  backup  files) 

A6  NOS  6/12  display  code  — >  7-bit  ASCII 
A8  NOS  8/12  display  code  — >  7-bit  ASCII 
D63  NOS  63-char  "  "  — >  7-bit  ASCII 

D64  NOS  64-char  "  "  — >  7-bit  ASCII 

(default:  A6) 


U 


alternate  user  name  (to  fetch  another  user's 
file) 
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PW  -  password  for  other  user's  file 

Remarks:  MSACCES  is  required  before  using  the  MSx  commands. 

Similar  commands:  COS:  MSFETCH  (DTRC) 

NOS:  ATTACH;  GET 
VMS:  HFT  FETCH  (DTRC) 

Examples:  /MSACCES,MPW=mymsspw 

/MSFETCH,mssfyl 1 , ini 

A —  MSSFYLl  is  retrieved  and  stored 
as  file  INI  in  your  current 
catalog 

/MSFETCH  mssfyl2  in2  D64 

A —  MSSFYL2  is  retrieved,  converted 
from  64-character  NOS  Display 
Code  and  stored  as  file  IN2  in 
your  current  catalog 

/MSFETCH  thatfyl  in3  UN=abcd 

A —  fetch  another  user's  file  THATFYL 
and  store  as  your  file  IN3 


MSPASSW  (DTRC)  Change  your  Mass  Storage  System  access  password. 


Syntax:  MSPASSW 

0  or  OLD  or  OPW  or  OLD_PASSWORD=name 
N  or  NEW  or  NPW  or  NEW  PASSWORD=name 


STATUS=status  variable 


Parameter':  "  -  Attributes:  CENTRE) 

your  current  MSS  access  password 

N  -  (Attributes:  SECURE) 

your  new  MSS  access  password 

Remarks:  MSACCES  is  required  before  using  the  MSx  commands. 


Similar  commands:  COS:  MSPASSW  (DTRC) 

NOS:  PASSWOR 

VMS:  HFT  PASSWORD  (DTRC) 

Examples:  /MSACCES, MPW=mymsspw 

A —  access  the  MSS 
/MSPASSW,OLD=mymsspw, NEW=numsspw 
-or- 

/MSPASSW  mymsspw  numsspw 
-or- 

/MSPASSW  N=numsspw  0=mymsspw 

A —  the  above  are  the  same 
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MSPURGE  (DTRC)  Purge  a  file  on  the  Mass  Storatge  System. 

Syntax:  MSPURGE 

F  or  FN  or  MFN  or  FILES  or  FILE=list  of  file 


STATUS=status  variable 

Parameters:  F  -  a  single  MSS  filename  or  a  comma-separated 
list  of  files  enclosed  in  parentheses 

Remarks:  MSACCES  is  required  before  using  the  MSx  commands. 

Similar  commands:  COS:  MSPURGE  (DTRC) 

NOS:  PURGE 

VMS:  HFT  DELETE;  MSSDELETE  (both  DTRC) 

Examples:  /MSPURGE  F=mymssl 

A--  purge  MSS  file  MYMSS1 

/MSPURGE  (fl,f2,f3,f4,f5) 

A-~  purge  MSS  files  Fl,  F2,  F3,  F4, 
and  F5 


MSSTORE  (DTRC)  Store  a  file  on  the  Mass  Storage  System. 


Syntax:  MSSTORE 

F  or  FR0M=f i le 


T  or  MFN  or  TO=name 

DC  or  DATA_CONVERSION=keyword 

TY  or  TYPE=keyword 

CT  or  CATEGORY_TYPE=keyword 

PW  or  PASSWORD 

M  or  FILE_ACCESS_MODE=keyword 
BR  or  BACKUP_REQUIREMENTS  or 

BACKUP_REQUIREMENT=keyword 
STATUS=status  variable 

Parameters:  F  -  the  name  of  the  NOS/VE  file 

T  -  the  name  for  the  file  on  the  MSS 
(1-7  alphanumeric  characters) 
(default:  <from>) 


DC  -  how  the  file  is  to  be  transferred 
dc  meaning 


B60  rightmost  60  NOS/VE  bits  — >  NOS 
word;  leftmost  4  bits  ignored 
B56  contiguous  NOS/VE  bits  — >  rightmost 
56  NOS  bits;  leftmost  4  NOS  bits  set 
to  0  (use  for  NOS/VE  object  libraries, 
SCU  libraries,  permanent  file  backup 
files) 
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A6  7-bit  ASCII  — >  NOS  6/12  display  code 

A8  7~bit  ASCII  — >  NOS  8/12  display  code 

D63  7-bit  ASCII  — >  NOS  63-char  "  " 

D64  7-bit  ASCII  — >  NOS  64-char  "  " 

(default:  A6) 

TY  -  the  type  of  file  on  the  MSS 

type  meaning 


D  or  DA  or 
DIR  or  DIRECT 
I  or  IA  or 
IND  or  INDIRECT 
SAME 


(default:  SAME) 

CT  -  the  new  category 
ct 


direct  access 

indirect  access 
same  as  existing 
MSS  file;  if  none, 
then  direct  access 


type 

access 


P  or  PR  or  PRIVATE 
PU  or  PUBLIC 

S  or  SPRIV  or  SEMI  PRIVATE 


(default:  no  change) 
M  -  the  file  access  mode 


ab 

m 

meaning 

E 

EXECUTE 

execute  only 

R 

READ 

read  only 

RU 

READUP 

read  and  update 

RA 

READAP 

read  and  append 

RM 

READMD 

read  and  modify 

U 

UPDATE 

update  only 

A 

APPEND 

append  only 

M 

MODIFY 

modify  only 

W 

WRITE 

write  only 

(default:  not  specified  -  same  as  WRITE) 


only  you 
everyone 
everyone  with 
a  record  of 
all  accesses 


BR  -  the  backup  requirements  for  the  file 


br 

meaning 

CR 

off-station 

Y 

on-station 

MD 

only  if  on  disk 

N 

no  backup 

(MD  and  N  are  not  recommended) 
(default:  not  specified  (same  as  Y)) 
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PW  -  (Attributes:  SECURE) 

the  new  password  ~or~ 

CLEAR  -  remove  the  existing  password 
(default:  no  password  for  the  file) 

Similar  commands:  COS:  MSSTORE  (DTRC) 

NOS:  DEFINE;  SAVE 

VMS:  HFT  STORE;  MSSBACKUP  (both  DTRC) 

Examples:  /MSACCES ,MPW=mymsspw 

A —  access  the  MSS 

/MSSTORE, ini .mssfyll 

A —  INI  is  stored  as  private,  direct 
file  MSSFYLl 

/MSSTORE  in2  mssfyl2  D64  PW=fylepw 

A —  IN2  is  stored  as  private  file 

MSSFYL2  (even  if  MSSFYL2  already 
exists)  in  CDC  Display  Code  — 
FYLEPW  is  the  password  required 
for  another  user  to  access  the 
file  —  if  MSSFYL2  does  not 
exist,  this  will  be  a  direct  file 

/MSSTORE  in3  mssfyl3  A6  I  PU 

A —  IN3  is  stored  as  public,  indirect 
file  MSSFYL3  in  64-character 
Display  Code 


NEW_ROUTINES 

(DTRC)  Display  a  description  of  recently-added  routines  or 
copy  the  information  into  a  file. 

Syntax:  NEW_ROUTINES  -or- 

NEWR 


0  or  0UTPUT=f ile 

STATUS=status  variable 

Parameters:  0  -  the  file  to  which  the  information  is  to  be 

copied 

(default:  SOUTPUT) 

See  also:  NEWS;  OLDNEWS 

Similar  commands:  NOS:  BEGIN, NEWRTNS  (DTRC) 

VMS:  NEWROUTINES  (DTRC) 

Examples:  /NEWR  < —  display  information  about  new 

routines  at  your  terminal 

$local . r 

A —  copy  the  information  into  your 
local  file  R 


/NEWR 


Page  H-128 


RevO 


90/09/30 


NEWS  (DTRC)  Display  the  current  news  file  or  copy  it  into  a  file. 

Syntax:  NEWS 


0  or  OUTPUT=f i le 

STATUS=s tatus  variable 

Parameters:  0  -  the  file  to  which  the  news  file  is  to  be 
copied 

(default:  SOUTPUT) 

See  also:  NEW_ROUTINES ; 

Similar  commands:  NOS:  BEGIN, NEWS  (DTRC) 

VMS:  NEWS  (DTRC) 

Examples:  /NEWS  < —  display  the  news  at  your  terminal 

/NEWS  Slocal.n 

A —  copy  the  news  file  into  your 
local  file  N 


OLD_NEWS 

(DTRC)  Display  the  old  news  file  or  copy  it  into  a  file. 

Syntax:  OLD_NEWS  ~or~ 

OLDN 


0  or  OUTPUT=f i le 

STATUS=status  variable 

Parameters:  0  -  the  file  to  which  the  old  news  file  is  to  be 

copied 

(default:  SOUTPUT) 

See  also:  NEW_ROUTINES ;  NEWS 

Similar  commands:  NOS:  BEGIN, OLDNEWS  (DTRC) 

VMS:  OLDNEWS  (DTRC) 

Examples:  /OLD_NEWS  < —  display  the  old  news  at  your 

terminal 

/OPLDN  Slocal.o 

A —  copy  the  news  file  into  your 
local  file  0 


OPEN_FILE_MIGRATION_AID 

Begin  the  file  migration  environment. 

Syntax:  OPEN_FILE_MIGRATION_AID  -or- 

OPEFMA 


PJC  or  PARTNER_ JOB_CARD=  string 
STATUS=status  variable 
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Parameters:  PJC  -  job  statement  parameters  for  NOS  job  in 

NOS  syntax 

(defaults:  batch:  infinite  time 

interactive:  no  job  parameters) 

Remarks:  OPEFMA  initiates  a  NOS  batch  job  (partner  job). 

Subcommand  prompt:  fa/ 

Examples:  /opefma 

fa/open_170_state 

fa/ execute_command  ' attach, binfi le ' 
fa/ec  'file, binfile,fa=sq,bt=i,mr 1=90. 
fa/cl os e_environment 
fa/execute_migration_task 
fa/migration_f ile=(binfile,  .. 
fa. ./newf ile, cl70_to_cl80)  f ile=lgo 
fa/close  environment 


PASCAL  Compile  a  PASCAL  program. 


Syntax:  PASCAL 


I  or  INPUT=f i le 

B  or  BINARY  or  BO  or  BINARY_0B JECT=f ile 

L  or  LIST=f ile 

E  or  ERROR=file 

EL  or  ERROR_LEVEL=keyword 

LO  or  LIST_OPTION  or 

LIST _OPTIONS=keyword  or  list  of  keyword 
OL  or  OPTIMIZATION_LEVEL  or  OPTIMIZATION  or 
OPT=keyword 

DA  or  DEBUG_AIDS=1 ist  of  keyword 
RC  or  RUNTIME_CHECKS=keyword  or 

list  of  keyword 

SD  or  STANDARDS_D I AGNOSTICS* keyword 
TEL  or  TERMINATION_ERROR_LEVEL=keyword 
ISM  or  INPUT_SOURCE_MAP=f i 1 e 
ISM  or  INPUT_SOURCE_MAP=f i 1 e 
STATUS=s tatus  variable 


Parameters:  I  -  SlNPUT  -  you  will  be  prompted  for  each 

source  line  —  end  with  *E0I 

B  -  $NULL  -  syntax  check  only 

E  -  $NULL  -  no  error  file  is  written 

EL  -  (W,  F,  C) 

(default:  WARNING) 
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LO  -  compiler  output  listing  options 
lo  meaning 


A  list  entity  attributes 

0  object  code  listing  (do  not  use  at 

DTRC  unless  requested  by  User 
Services) 

R  cross  reference  listing 

S  list  source  program 

NONE  no  output  listing 
(default:  S;  multiple:  (op,...,op)) 

OL  -  controls  optimization 

option  meaning 


LOW  keep  constant  values  in  registers 
DEBUG  stylized  for  debugging 
(default:  LOW) 

DA  -  debugging  options 

option  meaning 


DT  generate  line  number  and  symbol 

tables 

ALL  all  debugging  options  (DT) 

NONE  no  debugging  options 

(default:  NONE) 

RC  -  controls  execut i on~t ime  checking 
re  meaning 


F  errors  in  file  and  buffer  variables 

E  mis-use  or  pointer  and  buffer 
variables  and  NEW  and  DISPOSE 
procedures 

R  range  checking  for  subrange  and  set 

assignment  and  case  variables 
S  array  subscript  bounds 

NONE  no  checks 
ALL  all  run-time  checks 
(default:  NONE) 

SD  -  controls  non-ISO/non-ANSI  diagnosis 
(level, std)  meaning 


(w) 

ISO 

errors 

=  > 

WARNING 

(F) 

ISO 

errors 

=  > 

FATAL 

(W.ISO) 

ISO 

errors 

=  > 

WARNING 

(F , ISO) 

ISO 

errors 

=  > 

FATAL 

(W,  ANSI) 

ANSI 

errors 

=  > 

WARNING 

(F.ANSI) 

ANSI 

errors 

=  > 

FATAL 

(NONE) 

standard  errors 

not 

diagnosed 

(default : 

NONE) 
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POP 


PRINT 


TEL  -  minimum  severity  level  for  returning 
abnormal  status  (W,  F,  C) 

ISM  -  (attribute:  BY_NAME) 

the  file  generated  by  the  OSM  option  on  the 
SCU  EXPAND_DECK  command 
(default:  $NULL) 

Similar  commands:  NOS,  VMS:  PASCAL 

Examples:  /pascal  pas_source  lo=none 


Delete  the  current  version  of  an  environment  object  or 

variable  and  restore  to  its  former  value. 

Syntax:  POP  environments 

Parameters:  environments  -  one  or  more  (comma  or  space 

serparated)  of: 
environment  object 
environment  variable 
COMMAND_LIST 
FILE_CONNECTIONS 
INTERACTION_STYLE 
MESSAGE_LEVEL 
NATURAL_LANGUAGE 
PROGRAM_ATTRIBUTES 
WC  or  WORKING_CATALOG 

Remarks:  Error  if  environment  object  or  variable  was  not 

established  (pushed). 

See  air-:  PUSH 


FILE 

Print  one  or  more  files. 

Syntax:  PRINT_FILE  ~or- 

PRINT_FILES  -or- 
PRIF 


F 

or 

FILES  or  FILE=1 ist  of  file 

CB 

or 

COMMENT  BANNER=string 

C 

or 

COPIES=integer 

DM 

or 

DATA  MODE=keyword 

D 

or 

DEVICE=keyword  or  name 

EPT 

or 

EARLIEST_PRINT_TIME=keyword  or 

date  time 

EC 

or 

EXTERNAL_CHARACTERISTICS=keyw1 

name 

FC 

or 

FORMS  CODE=keyword  or  string 

LPT 

or 

LATEST_PRINT_TIME=keyword  or 

date  time 

Page  H-132 


RevO 


90/09/30 


OF  or  OPERATOR_FAMILY  or 

DESTINAT ION_FAMI LY  or  DF=naroe 
OU  or  OPERATOR_USER  or 

STATION_OPERATOR  or  SO=name 
OC  or  OUTPUT_CLASS=keyword 
ODBU  or  OUTPUT_DEFERRED_BY_USER=boolean 
ODE  or  OUTPUT_DESTINATION=name  or  string 
ODU  or  OUTPUT_DES T I NAT I ON_USAGE  or 

DESTINATION__USAGE  or  DU=keyword  or 

name 

OP  or  OUTPUT_PRIORITY=keyword 

PD  or  PURGE_DELAY=keyword  or  t ime_increment 

RHD  or  REMOTE_HOST__DIRECTIVE  or 

DUAL_STATE_ROUTE_PARAMETERS  or 
DSRP=s  tr ing 

RB  or  ROUTING_BANNER=s tring 
S  or  STATION=keyword  or  name 
UFN  or  USER_FILE_NAMES  or 

USER_FILE_NAME=list  of  file 
UI  or  USER_INF0RMATI0N=s tring 
VPD  or  VERTICAL_PRINT_DENSITY=keyword 
VLP  or  VFU_LOAD_PROCEDURE=keyword  or  name 
SFN  or  SYSTEM_FILE_NAME=name  variable  or 

list  of  name  variable 
STATUS=status  variable 

Parameters:  CB  -  string  to  be  displayed  with  the  output 

(default:  CB  job  attribute  -  if  null,  the 
file  name) 

C  -  number  of  copies 

DM  -  one  of: 

ab  option  meaning 


C  CODED  the  file  contains  codes 

to  be  interpreted  by  the 
printer 

T  TRANSPARENT  print  the  file  without 
conversion  or 
interpretation 

(cannot  be  used  if  ODU=DUAL_STATE) 

D  -  name  that,  together  with  STATION, 
identifies  the  printer  -or- 
AUTOMATIC  -  any  printer  with  the  EC  and 
FC  needed 

EPT  ~  the  earliest  time  to  print  the  file  -or- 
NONE  -  print  any  time 

EC  -  l~to  6-character  string  -or- 

NORMAL  -  a  printer  with  EC=NORMAL 
(mapped  to  A9  on  NOS) 
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FC 

LPT 

OF 

OU 

OC 

ODBU 

ODE 

ODU 


! 


l~to  6-character  string  -or- 
NORMAL  -  a  printer  with  FC=NORMAL 

if  not  printed  by  this  time,  the  file  is 
discarded  -or- 

NONE  -  no  restrictions  on  print  time 

family  name  of  a  private  station  or 
remote  system  operator  that,  together 
with  OU,  identifies  the  private  or  remote 
operator  who  can  print  or  receive  the 
file  (requires  ODU=PRIVATE  or  NTF) 

family  name  of  a  private  station  or 
remote  system  operator  that,  together 
with  OF,  identifies  the  private  or  remote 
operator  who  can  print  or  receive  the 
file  (requires  ODU=PRIVATE  or  NTF) 

define  the  initial  and  maximum  priorities, 
and  the  aging  interval  and  factor  for  the 
output  file 

NORMAL  -  only  class  available 

TRUE  =>  defer  printing 
FALSE  =>  do  not  defer  printing 

where  the  output  file  is  to  be  sent  for 
printing  if  ODU=QTF  or  NTF 

one  of: 

.  the  kind  of  CDCnet  print  station 
.  the  queue  file  transfer  application 
to  be  used  to  send  the  file  to  a  remote 
system 


odu 

meaning 

PUBLIC 

a  public  CDCnet  batch  I/O 
station 

(OF,  OU,  ODE,  RHD  ignored) 

PRIVATE 

a  private  CDCnet  batch  I/O 
station 

(ODE,  RHD  ignored) 

DUAL_STATE 

printed  by  NOS 

(only  FC,  C,  RB,  RHD  used) 

QTF 

send  the  file  to  remote  ODE 
station 

NTF 

send  the  file  to  remote  ODE 
NTF  system 

(default:  ODU  used  unless  0D1=L0CAL,  then 
system  default  used) 
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Remarks : 

See  also 
Simi lar 


OP  -  priority  increment  to  add  to  the  initial 
priority 

value  increment 


LOW  0 

MEDIUM  1500 

HIGH  3000 

PD  -  how  long  to  retain  the  file  in  the  output 
queue  after  printing  -or- 
NONE  -  no  delay 

RHD  -  either: 

.  a  NOS/VE  PRINT_FILE  command 
.  a  NOS  ROUTE  command 
.  the  NOS  ROUTE  command  parameters 
(ignored  unless  ODU  has  the  appropriate 
value) 

RB  -  string  to  be  displayed  with  the  output 

(default:  RB  job  attribute  -  if  null,  the 
user  name  for  the  file) 

S  -  the  I/O  station  name  for  sending  the  file 
AUTOMATIC  -  use  the  "ystem  default 

UFN  -  names  to  go  with  the  files  listed  in  FILE 
(default:  each  file's  name) 

VPD  -  vertical  print  density 
vpd  meaning 


SIX  6  lines  per  inch 

EIGHT  8  lines  per  inch 

NONE  any  printer 

FILE  vpd  of  source  file  used 

6  -  SIX 

7-12  -  EIGHT 

VLP  -  name  of  a  procedure  with  the  vertical 
forms  unit  (VFU)  image  to  be  loaded  to 
control  the  printer 

SFN  -  name  of  a  variable  of  type  LIST  to  receive 
the  generated  system  names  for  the  files 
(default:  ignored) 

Except  for  UFN,  DM  and  SFN,  all  defaults  are  the 

corresponding  job  attributes. 

:  CHANGE_OUTPUT_ATTRIBUTE ,  DISPLAY_OUTPUT_STATUS 

commands:  COS:  DISPOSE  to  a  front-end 
NOS:  ROUTE 

VMS:  PRINT;  QPRINT  (DTRC) 
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Examples:  /print_file  file=myout  copies=5 

A —  print  5  copies  of  file  MYOUT 
/display_output_status  all 

A —  produces  the  following  (sample) 
Output_State  :  printing 

System_File_Name  :  $0990_0102_aad_lA39 

User_File_Name  :  myout 

/disos  name=all 

A —  after  printing  produces 
None  Were  Found. 


/prif  f ortran_l i st ing  /odu=dual_state  .. 
. . / rhd= ' dc=pr , ec=a9 ' 

A —  print  on  NOS  printer 


PROCEDURE 

First  statement  of  an  SCL  procedure  defining  the  procedure's 

names,  attributes,  and  parameters. 

Syntax:  PROCEDURE  (attributes)  procedure_names  ( 

parameter  definition 
•  ■  • 

) 

statement  list 
PROCEND  procedure^name 

Parameters:  attributes  -  any  of: 

.  the  name  of  a  help  module 
.  XDCL  -  the  procedure  can  be 
called  from  outside 
its  object  library 
and  by  commands 
within  that  library 
.  ADVANCED  -  the  procedure  is  not 
listed  by  DISCLE 
unless  requested  by 
the  DO  parameter 

.  HIDDEN  -  the  procedure  is  not 
listed  by  DISCLE 

proc_names  -  the  procedure  name  and  its  aliases: 
name,  alias,  ...,  alias 

param_defs  ~  define  the  procedure  parameter: 

parameter_names  :  (attributes)  type 
expression  =  default 

Remarks:  Procedure_name  is  optional  on  the  PROCEND 

statement  —  if  used,  it  must  be  the  first 
procedure  name: 

PROCEDURE  display_number ,  di splay_numbers ,  .. 
di  sn 


PROCEND  display_number 
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The  statement  list  may  not  contain  another 
PROCEDURE/PROCEND . 

An  SCL  procedure  constitutes  its  own  block. 

WARNING:  NOS/VE  has  two  procedure  interpreters.  The  old 

one  is  invoked  by  PROC  and  is  not  recommended 
because  it  does  not  support  all  features.  The 
new  one  is  invoked  by  PROCEDURE. 

Similar  commands:  COS:  PROC 

NOS:  .PROC 
VMS:  .COM  file 

Examples:  PROCEDURE  display_number ,  display_numbers ,  disn  ( 

number,  numbers,  n  :  list  1..10  of  range  of  .. 

integer  -100.. 100  =  Srequired 
output,  o  :  file  =  Soutput 
status) 

*  •  • 

PROCEND 

A —  procedure  name  is  DISPLAY_NUMBER 
(alternate  names  DISPLAYNUMBERS 
and  DISN)  —  parameter  NUMBER 
(or  NUMBERS  or  N)  is  required 
and  is  a  list  of  1-10  value  sets, 
each  having  1  or  2  values,  each 
value  an  integer  in  the  range 
-100  thru  100 
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PURGE  (DTRC)  Delete  cycles  of  one  or  more  files  keeping  the 
specified  number  of  high  cycles. 

Syntax:  PURGE 

F  or  FILE  or  FILES=list  of  file 


K  or  KEEP=integer 
L  or  LOG=keyword 

STATUS=s tatus  variable 

Parameters:  K  -  the  number  of  high  cycles  of  each  file  to 
keep 

(default:  1) 

L  -  controls  logging  the  process 

LOG  -  display  the  filenames  as  they  are 
deleted 
(synonym:  L) 

N0L0G  -  do  not  display  them 
(synonyms:  N,  NOL) 

(default:  NOLOG) 

See  also:  DELETE;  DELETE_ALL_CYCLES 

Similar  commands:  COS:  PURGE, KEEP= 

NOS:  PURGE 
VMS:  DELETE 

Examples:  /purge  e* 


PUSH 


Temporarily  change  environment  objects  or  variables  in  an 
SCL  procedure. 


Syntax:  PUSH  environments 


Parameters:  environments  -  one  or  more  (comma-  or  space- 

separated)  of: 
environment  object 
environment  variable 
C0MMAND_LIST 
FILE_C0NNECTI0NS 
INTERACTION  STYLE 
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MESSAGE_LEVEL 
NATURAL_LANGUAGE 
PROGRAM_ATTRIBUTES 
WC  or  WORKING_CATALOG 

Remarks:  Only  the  most  recently  pushed  version  of  the 

system  environment  can  be  referenced  or 
changed. 

A  specific  object  can  be  pushed  only  once  in  a 
procedure . 

See  also:  POP 


PUSH_COMMANDS 

Move  the  command  list  entry  containing  the  procedure  that 
called  this  statement  to  the  top  of  the  command  list. 

Syntax:  PUSH_COMMANDS 

Remarks:  The  command  list  entry  is  returned  to  its 

original  position  when  the  procedure  is  exited 
or  when  the  command  list  is  restored  using  POP. 


PUT_LINE 

Write  lines  to  a  file. 

Syntax:  PUT_LINE  -or- 

PUT_LINES  -or- 
PUTL 

L  or  LINES=list  of  string 


0  or  OUTPUT=file 

STATUS=status  variable 

Parameters:  L  -  the  lines  to  be  written 

Remarks:  PUTL  never  adds  page  titles  or  format  effectors. 

The  first  character  is  assumed  to  be  a  format 
effector  (carriage  control) . 

COLLECT_TEXT  is  faster  for  writing  more  than  one 
line  in  succession  since  it  opens  the  file  once, 
while  PUTL  opens  the  file  each  time  it  is  called. 

PUTL  allows  substitution  for  variables  and  string 
expressions . 

See  also:  COLLECT_TEXT 

Similar  commands:  COS,  NOS:  NOTE 

VMS:  WRITE 
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Examples:  /put_lines  lines=(  .. 

. ./'  Today's  date:  ' //$date (month)  .. 

.  ./'  The  current  time:  ' //$time (ampm)  .. 

. ./’  Welcome  to  NOS/VE. ') 

Today's  date:  January  25,  1990 
The  current  time:  11:10  AM 

Welcome  to  NOS/VE. 


RATES  (DTRC)  Display  the  current  Computer  Center  rate*?  or  put  them 
into  a  file. 

Syntax:  RATES 


0  or  OUTPUT=f i le 

STATUS=s tatus  variable 

Parameters:  0  -  the  file  to  which  the  news  file  is  to  be 
copied 

(default:  SOUTPUT) 

Similar  commands:  NOS:  BEGIN, RATES  (DTRC) 

VMS:  HELP  RATES  (DTRC) 

Examples:  /RATES  < —  Display  the  rates  at  your 

terminal 

/RATES  SLOCAL.R 

A —  Copy  the  rates  to  local  file  R 

RELEASE_RESOURCE 

Release  tape  reservations. 

Syntax:  RELEASE_RESOURCE  -or_ 

RELEASE_RESOURCES  -or- 
RELR 


MT9$800=keyword  or  integer 
MT9$1600=keyword  or  integer 
MT9$6250=keyword  or  integer 
STATUS=status  variable 

Parameters:  MT9$den  -  number  of  tape  drives  of  density 

<den>  which  the  job  no  longer  needs 
ALL  -  all  resource  of  this  kind 
(default:  0) 

See  also:  RESERVE_RESOURCE 

Similar  commands:  NOS:  RETURN 

Examples:  /relr  mt9$1600=l  mt9$6250=2 

A —  release  1  1600-cpi  and 
2  6250-cpi  tape  drives 
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REPEAT  Conditionally  repeat  a  statement  list. 

Syntax:  label:  REPEAT 

statement  list 
UNTIL  bool ean_expression 

Parameters:  label  -  the  name  of  the  REPEAT  block  -  may  be 

used  by  CYCLE  or  EXIT 

bool_exp  -  the  terminating  condition 

Subcommand  prompt:  repeat/ 

Similar  commands:  VMS:  DO  WHILE 


REPLACE_FILE 

Copy  a  NOS/VE  file  to  NOS  direct  file,  replacing  any  existing 
file. 


Syntax:  REPLACE_FILE  -or- 

REPF 

T  or  T0=file 


F  or  FROM=f ile 
DC  or  DATA_CONVERSION=keyword 
U  or  ID  or  USER=name  or  string 
PW  or  PASSWORD  or  TURNKEY  or  TK=name 
XR  or  EXCLUSIVE_ACCESS=name  <—  not  at  DTRC 

C  or  CY  or  CYCLE=integer  < —  not  at  DTRC 

STATUS=status  variable 


Parameters:  F 


the  NOS/VE  file  (may  be  positioned) 


T  -  the  NOS  file 

(default:  the  file  name  component  of  FROM) 


DC  -  type  of  conversion  to  be  done 
dc  meaning 


B60  rightmost  60  bits  of  each  NOS/VE 

word  into  NOS  word  with  leftmost  4 
NOS/VE  bits  ignored 

B56  contiguous  NOS/VE  bits  packed  into 
rightmost  56  bits  of  NOS  words  with 
leftmost  4  NOS  bits  set  to  0  (zero) 

A6  7/8  ASCII  converted  to  6/12  NOS 
display  code 

A8  7/8  ASCII  converted  to  8/12  NOS 
ASCII 

D63  7/8  ASCII  converted  to  6~bit  NOS 

display  code  (63-character  set) 
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D64  7/8  ASCII  converted  to  6~bit  NOS 

display  code  (64-character  set) 
(default:  A6) 

U  -  alternate  NOS  user 

PW  -  (attribute:  SECURE) 

NOS  password  only  required  if  you  don't 
own  the  file 

Remarks:  CHANGE_LINK_ATTRIBTUE  prior  to  GETF  identifies 

the  accounting  and  user  information  for  accessing 
the  file. 

DC=D64,  A6,  or  A8  create  zero-byte  terminated 
(Z-type)  NOS  records. 

See  also:  GETJFILE;  MS  FETCH”,  MSSTORE 

Similar  commands:  COS:  MSSTORE  (DTRC) 

NOS:  PURGE/DEFINE;  REPLACE 

VMS:  HFT  STORE;  MSSBACKUP  (both  DTRC) 

Examples:  /repf  my_file  myfile 

A—  copies  NOS/VE  file  MY  FILE  to 

NOS  as  MYFILE,  replacing  any 
existing  NOS  file  with  the  same 
name 


REQUEST_MAGNETIC_TAPE 

Associate  a  file  with  a  magnetic  tape. 

Syntax:  REQUEST_MAGNETIC_TAPE  -or- 

REQMT 

F  or  FILE=f ile 


EV  or  EVSN  or  EXTERNAL_VSN=1 ist  of:  string 

or  name 

L  or  L0G=boolean 

PW  or  PASSWORD=keyword  or  name 

RV  or  RVSN  or  REC0RDED_VSN=1 ist  of:  string 

or  name 

RMG  or  REMOVABLE_MEDIA_GROUP=keyword  or  name 
R  or  RING=boolean 

T  or  TYPE  or  DENSITY  or  D=keyword 

VOA  or  V0LUME_0VERFL0W_ALL0WED=booi ean 
STATUS=status  variable 

Parameters:  (attribute:  BY_NAME,  ail  except  F) 

F  -  the  file  name  for  the  tape  —  should  reside 
in  $ LOCAL 
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Remarks : 


EV  -  the  external  sticker  number  ( 1 — 6 

characters)  —  if  more  than  one,  they  are 
requested  in  the  order  specified 
(default:  RECORDED_VSN  is  used) 

PW  -  (additional  attributes:  ADVANCED,  SECURE) 
the  password  for  all  cycles  of  a  file 

RV  -  the  VSN  written  in  the  ANSI  VOL1  label 

(1~6  characters)  —  of  more  than  one,  they 
are  located  and  verified  in  the  order 
specified 

(default:  EXTERNAL_VSN  is  used) 

(note:  either  EV  or  RV  must  be  specified) 

RMG  -  (additional  attribute:  ADVANCED) 

1-  to  13-character  name  of  a  group  of  tape 
volumes  managed  by  RMS  that  is  used  to 
assign  volume  to  the  file  cycle 

R  -  specifies  if  the  write  ring  is  needed  in 
each  volume  of  the  file 
value  meaning 

TRUE  the  ring  must  be  in  (write  or  read) 

FALSE  the  ring  must  be  out  (read  only) 
(default:  FALSE) 

T  -  the  tape  type  (density)  of  the  tape(s) 
value  meaning 


MT9S800  9-track,  800  cpi 
MT9S1600  9-track,  1600  cpi 
MT9S6250  9-track,  6250  cpi 
(default:  value  of  OSD$REQMT_DEFAULT_ 
DENSITY;  if  it  doesn't  exist, 
MT9S1600) 

VOA  -  (additional  attribute:  ADVANCED) 

controls  whether,  for  this  attachment  only, 
this  is  a  multi-reel  volume 
(default:  FALSE) 

Tape  mounting  is  not  requested  until  the  file  is 
used. 

New  tapes  must  be  blank  labeled  by  the  operator. 

CHATLA  must  set  REWRITE_LABELS  to  TRUE  for  the 
first  use. 


Similar  commands:  NOS:  LABEL 

VMS:  MOUNT 


90/09/30 


RevO 


Page  H~143 


Examples:  /reqmt  f i le=$local . tapel  type=mt9$6250  .. 

• . /ev= ' NA9876 '  ring=true 

/chatla  file=$local . tapel  rewrite_iabels=true 
/copy_file  filel  $local. tapel 
/detach_file  Slocal. tapel 

REQUEST_TERMINAL 

Associate  a  file  with  a  terminal  in  an  interactive  job. 

Syntax:  REQUEST_TERMINAL  -or- 

REQT 

F  or  FILE=f ile 


STATUS=status  variable 


RESERVE_RESOURCE 

Specify  the  number  of  tape  units  to  be  reserved. 


Syntax:  RESERVE_RESOURCE  -or- 

RESERVE_RESOURCES  -or- 
RESR 


MT9$800=keyword  or  integer 
MT9$1600=keyword  or  integer 
MT9$6250=keyword  or  integer 
STATUS=status  variable 

Parameters:  MT9$den  -  number  of  tape  drives  of  density 

<den>  which  the  job  needs 
(default:  0) 

See  also:  RELEASE  RESOURCE 


Similar  commands:  NOS:  RESOURCE 


Examples:  /relr  mt9$1600=l  mt9$6250=2 

A —  release  1  1600-cpi  and 
2  6250-cp i  tape  drives 


RESTORE_FOREIGN_FILES 

Begin  a  RESTORE_FOREIGN_FILES  utility  session  to  migrate 
NOS  tape  files  to  NOS/VE. 

Syntax:  RESTORE_FOREIGN_FILES  -or- 

RESFF 


L  or  LIST  or  OUTPUT  or  0=file 
STATUS=status  variable 

Parameters:  L  -  (default:  SOUTPUT) 
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RES TORE_PERMANENT_F I LES 

Begin  a  RESTORE_PERMANENT_FILES  utility  session. 

Syntax:  RESTORE_PERMANENT_FILES  -or- 

RESTORE_PERMANENT_FILE  or 
RESPF 


I  or  LIST=f i le 

STATUS=status  variable 

Remarks:  Use  SET_LIST_OPTION  subcommand  before  the 

RESTORE_PERMANENT_FILE  subcommand  to  define  the 
contents  of  the  list  file.  Default:  modification 
date/time  and  size  for  each  permanent  file  cycle. 

Subcommand  prompt:  P’JR/ 

Examples:  /respf  l=$local . taperd_log 

PUR/resec  <parameters> 

PUR/quit 

/ 


RESUME_COMMAND 

Resume  a  job  activity  interrupted  by  a  pause  break. 
Syntax:  RESUME_COMMAND  -  ->r- 

r  use 


STATUS=status  variable 
Similar  commands:  VMS:  CONTINUE 


REWIND_FILE 

Position  a  file  at  BOI  (beginning-of-information) . 

Syntax:  REWIND_FILE  -or- 

RFWF 

F  or  FILE  or  FILES=file 


STATUS=s tatus  variable 
Similar  commands:  COS,  NOS:  REWIND 
Examples:  /rewf  source 

A —  rewind  one  file 

/ rewind_f iles  f=(library, test, source) 
A —  rewind  3  files 
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ROUTE_JOB 

(for  input  from  cards,  or  a  PC  or  terminal  supporting  HASP) 
Name  a  job  and  the  output  destination. 

Syntax:  R0UTE_J0B  -or- 

ROUJ 

JN  or  JOB_NAME=name 

JD  or  JOB_DESTINATION=name 

JDO  or  JOB_OUTPUT_DESTINATION=name 

UN  or  USER_NAME=name 

UF  or  USER_FAMILY=name 

STATUS=s tatus  variable 


SELECT_USER_MENU 

Begin  the  NOS/VE  user  menu  system. 

Syntax:  SELECT_USER_MENU  -or- 

SELUM  -or- 

MENiJ 


1C  or  PROLOG_CALL=boolean 
NL  or  NATURAL_LANGUAGE=name 
STATUS=status  variable 

Parameters:  PC  -  reserved 

NL  -  (default:  US  ENGLISH) 


SEND_OPERATOR_MESSAGE 

Send  a  message  to  an  operator. 


Syntax:  SEND_OPERATOR_MEWSSAGE  ~or~ 

SENOM 

M  or  MESSAGE=s tr ing 


R  or  RESP0NSE= string  variable 
OC  or  OPERATOR_CLASS=k eyword 
STATUS=s tatus  variable 

Parameters:  M  -  the  message  to  be  send  ( 1  —  256  characters) 

R  ~  an  SCL  variable  to  receive  the  operator's 
response  (>=  256  characters) 

(default:  the  reply  message  is  put  into  the 
job's  log  and,  if  interactive, 

SOUTPUT) 
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OC  -  the 

class  of  operator 

ab 

option 

SO 

SYSTEM  OPERATOR 

RMO 

REMOVABLE  MEDIA  OPERATOR 

(default:  SO) 

Remarks:  The  job  is  suspended  until  the  operator  replies. 

Similar  commands:  VMS:  REPLY/REQUEST 

Examples:  /reply='' 

/senom  . . 

../m='Is  tape  AB1234  in  slot  99  yet?'  .. 

. . / r=reply 

A —  the  job  is  suspended 
/display_value  reply 
SORRY,  AB1234  IS  NOT  IN  SLOT  99 

A —  the  operator's  reply 

SET_COMMAND_LIST 

Add  to  and/or  delete  from  the  current  command  list,  and/or 
alter  the  state  of  the  search  mode  indicator. 

Remarks:  Use  instead: 

CREATE_COMMAND_L I ST_ENTR  Y  (CRECLE) 
DELETE_COMMAND_LIST_ENTRY  (DELCLE) 

CHANGE  COMMAND  LIST  ENTRY  (CHACLE) , 


SET_DEBUG_LIST 

Add  or  delete  debug  object  libraries  to/from  the  job  debug 
library  list. 

Syntax:  SET_DEBUG_LiST  -or- 

SETFL 


DL  or  DELETE_LIBRARY  or  DELETE_LIBRAR IES= 
list  of:  keyword  or  file 
AL  or  ADD_LIBRARY  or  ADD_LIBRARI ES= 1 i s t  of 

file 

STATUS=status  variable 

Parameters:  DL  -  list  of  file  -  libraries  to  be  deleted 

ALL  -  delete  all  libraries 

(default:  no  libraries  deleted) 

AL  -  list  of  file  -  libraries  to  be  added  at  the 

beginning  of  the  job  debug 
library  list 

(default:  no  libraries  added) 
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SET_DEBUG_RING 

Specify  the 

Syntax: 


Parameters : 
Examples : 


ring  in  which  Debug  is  to  execute. 

SET_DEBUG_RING  -or- 
SETDR 

R  or  RING=integer 

STATUS=status  variable 
R  -  the  Debug  ring  number  (1—13) 
/setdr  10 


SET_DEFAULT_LOGIN_PROJECT 

(DTRC)  Set  the  default  login  project  number  (job  order  number 
at  DTRC)  so  that  it  need  not  be  entered  at  future  logins. 

Syntax:  SET_DEFAULT_LOGIN_PROJECT  -or- 

SETDLP 


STATUS=status  variable 

Remarks:  After  your  login  project  has  been  set,  just  press 

RETURN  at  the  "Enter  Project  Number"  prompt. 

Similar  commands:  NOS:  CHVAL,CN 

Examples:  /setdlp 


SET_F I LE_ATTR I BUTES 

Set  the  attributes  of  a  file. 

Syntax:  SET_F I LE_ATTR IBUTES  -or- 

SET_FILE_ATTRIBUTE  -or~ 
SETFA 

F  or  FILE=file 


Ah 

or 

ACCESS_MODE  or 

ACCESS  MODES=list  of  keyword 

ARL 

or 

AVERAGE  RECORD_LENGTH= integer 

BT 

or 

BLOCK  TYPE=keyword 

CC 

or 

CHARACTER_CONVERSION=bool ean 

CTN 

or 

COLLATE  TABLE  NAME=keyword  or  name 

CPN 

or 

COMPRESS ION_PROCEDURE_NAME=keyword 
or  entry_point_ref erence 

DP 

or 

DATA  PADDI NG= i n t eger 

EK 

or 

EMBEDDED_KEY=boo  1 ean 

EEN 

or 

ERROR  EXIT  NAME  or 

EEPN  or 

ERR0R_EX I T_ PR OCEDURE_NAME= keyword 


or  name 
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Parameters : 


EL 

or 

ERROR  LIMIT=integer 

ERC 

or 

ESTIMATED  RECORD  COUNT= int eger 

FAP 

or 

FILE_ACCESS_PROCEDURE  or 

FAPN  or 

FILE_ACCESS_PROCEDURE_NAME=keyword 
or  name 

FC 

or 

FILE_CONTENTS=keyword  or  name 

FLT 

or 

FILE_LABEL  TYPE=keyword 

FL 

or 

FILE_LIMIT=integer 

FO 

or 

FILE_ORGANIZATION=keyword 

FP 

or 

FILE_PROCESSOR=keyword  or  name 

FS 

or 

FILE_STRUCTURE=keyword  or  name 

FW 

or 

FORCED  WRITE=keyword  or  boolean 

HPN 

or 

HASHING_PROCEDURE_NAME=keyword  or 
entry  point  reference 

IL 

or 

INDEX  LEVEL=integer 

IP 

or 

INDEX  PADDING= int eger 

IHBC 

or 

I N I T I AL_HOME_B LOCK _COUNT= integer 

IC 

or 

INTERNAL  CODE=keyword 

KL 

or 

KEY_LENGTH= int eger 

KP 

or 

KEY_POSITION=integer 

KT 

or 

KEY  TYPE=keyword 

LN 

or 

LINE  NUMBER=record 

LET 

or 

LOCK  EXPIRATION  TIME=ihteger 

LO 

or 

LOGG I NG_OP T I ONS  or 

LOGGING  OPTION=list  of  keyword 

LR 

or 

LOG  RESIDENCE=keyword  or  file 

MAXBL 

or 

MAXIMUM  BLOCK  LENGTH=integer 

MAXRL 

or 

MAX IMUM_RECORD_LENGTH= integer 

MC 

or 

MESSAGE  CONTROL=list  of  keyword 

MINBL 

or 

MINIMUM  BLOCK  LENGTH=integer 

MINRL 

or 

MINIMUM  RECORD  LENGTH=integer 

OP 

or 

OPEN_POS I T I ON=k  eywor d 

PC 

or 

PADDING_CHARACTER=str ing 

PF 

or 

PAGE  FORMAT=keyword 

PL 

or 

PAGE  LENGTH=integer 

PW 

or 

PAGE_WIDTH= int eger 

PV 

or 

PRESET  VALUE=integer 

RL 

or 

RECORD  LIMIT=integer 

RT 

or 

RECORD  TYPE=keyword 

RPB 

or 

RECORDS  PER  BLOCK= int eger 

SI 

or 

STATEMENT_IDENTIFIER= record 

UI 

or 

USER_INFORMATION=s tring 
STATUS=status  variable 

(attribute:  all  are  BY_NAME) 

AM  -  READ,  WRITE  (APPEND  +  MODIFY  +  SHORTEN), 
APPEND,  SHORTEN,  EXECUTE,  NONE 
(default:  ) 

BT  -  the  block  type 
ab  bt 


SS  SYSTEM_SPECIFIED 
US  USER  SPECIFIED 
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CC  -  conversion  between  internal  character 
code  and  ASCII  (TRUE  or  FALSE) 

(default:  FALSE) 

MAXBL  -  maximum  block  length  (0~65,A97)  in  bytes 

MAXRL  -  maximum  record  length  (1~65,A97)  in  bytes 
(  ANSI  fixed-length  records  only) 

MINBL  -  minimum  block  length  ( > 1 7)  in  bytes 
(default:  18  for  new  file) 

Remarks:  It  is  recommended  that  all  relevant  keyed-file 

attributes  be  specifically  set,  since  the 
defaults  are  sometimes  inappropriate. 

See  also:  SET_FILE_ATTRIBUTES 

Similar  commands:  NOS:  CHANGE;  FILE 

Examples:  /setfa  my_file  am=  (read, execute) 


SET_LINK_ATTRIBUTES 

Use  CHANGE  LINK  ATTRIBUTES. 


SET_PROGRAM_ATTRIBUTES 

Change  default  attributes  for  subsequent  programs  in  a  job.. 

Syntax:  SET_PROGRAM_ATTRIBUTES  -or- 

SET_PROGRAM_ATTRIBUTE  ~or~ 

SETPA 


LM  or  L0AD_MAP=file 
LMO  or  L0AD_MAP_0PTI0NS  or 

LOAD_MAP_OPTION=keyword  or 

list  of  keyword 
PV  or  PRESET_VALUE=keyword 
TEL  or  TERMINATION_ERROR_LEVEL=keyword 
DI  or  DEBUG_INPUT=f i le 
DO  or  DEBUG_OUTPUT=f i 1 e 
AF  or  ABORT_FILE=f i 1 e 
DM  or  DEBUG_M0DE=bool ean 
DL  or  DELETE_LIBRARY  or 

DELETE  LIBRARIES=keyword  or 
list  of:  keyword  or  file 
AL  or  ADD_LIBRARY  or 

ADD_LIBRARIES=1 ist  of:  keyword  or  file 
AO  or  ARITHMETIC_OVERFLOW=bool ean 
ALOS  or  ARITHMETIC  LOSS  OF  SIGNIFICANCE=boolean 
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Parameters : 


DF  or 
EO  or 
EU  or 
FI  or 
FLOS  or 
IBD  or 


DIVIDE_FAULT=boolean 
EXPONENT_OVERFLOW=boo 1 ean 
EXPONENT_UNDERFLOW=boolean 
FPI  or  FP_INDEFINITE=bool ean 
FP_LOSS_OF_SIGNIFICANCE=boolean 
IBDPD  or  INVALID  BDP  DATA=boolean 


STATUS=s tatus  variable 


LM  -  (initial  default:  $LOCAL.LOADMAP.$BOI) 

LMO  -  NONE,  SEGMENT  (S) ,  BLOCK  (B) , 

ENTRY_POINT  (EP) ,  CROSS_REFERENCE  (CR) , 

ALL 

(initial  default:  NONE) 

PV  -  ZERO  (Z) ,  FLOATING_POINT_INDEFINITE  (FPI) , 
INFINITY  (I) ,  ALTERNATE_ONES  (AO) 

(initial  default:  ZERO) 

TEL  -  WARNING  (W) ,  ERROR  (E) ,  FATAL  (F) 

(initial  default:  ERROR) 

DI  -  (initial  default:  COMMAND) 

DO  -  (initial  default:  SOUTPUT) 

AF  -  (initial  default:  $NULL) 

DM  -  default  debug  mode  (ON,  OFF) 

(initial  default:  OFF) 


DL  -  list  of  libraries  to  be  deleted  ~or~ 
ALL  -  reorder  your  library  list 
(OSF$TASK_SEPVICES_LIBRARY  -  the  system 

table) 


(initial 

«  ef aul t : 

none  deleted) 

AL 

-  list  of 

libraries 

to  be  added 

(initial 

default : 

none  added) 

AO 

-  ON,  OFF 
(initial 

default : 

ON) 

ALOS 

-  ON,  OFF 
(initial 

default : 

ON) 

DF 

-  ON,  OFF 
(initial 

def aul t : 

ON) 

EO 

-  ON,  OFF 
(initial 

default: 

ON) 

EU 

-  ON,  OFF 
(initial 

default : 

ON) 
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FI  -  ON,  OFF 

(initial  default:  ON) 

FLOS  -  ON,  OFF 

(initial  default:  OFF) 

IBD  -  ON,  OFF 

(initial  default:  ON) 


S  ET_S  ENS  E_SW ITCH 

Sets  sense  switches  on  or  off. 

Syntax:  SET_SENSE_SWITCH  -or- 

SET_SENSE_SWITCHS  -or- 
SETSS 


N  or  NAME  or  JOB_NAME  or  JN=na;ne 
ON=list  of  range  of  integer 
OFF=list  of  range  of  integer 

Parameters:  N  -  user-  or  system-supplied  job  name  (you 

control)  whose  sense  switches  are  to  be 
altered 

(default:  the  requesting  job) 

ON  -  the  switches  (1~8)  to  be  turned  on 
(default:  none  are  turned  on) 

OFF  -  the  switches  (1-8)  to  be  turned  off 
(default:  none  are  turned  off) 

Similar  commands:  NOS:  SWITCH 

Examples:  /set_sense_switches  on=(l,2,3) 

A —  turn  sense  switched  1,  2  and  3 
on  in  the  current  job 
/setss  jn=$0855_010A_pdq_0861  on=l  off=2 

A —  turn  SS  1  on  and  SS  2  off  in  a 
specific  job  you  control 
/setss  jn=myjob  of f =  (1 , 2 , 3, A, 5 , 6 , 7 , 8) 

A —  turn  off  all  sense  switches  in 
a  specific  job  you  control 
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SHOW_FILE 

Display  a  file  in  a  pop  up  window  that  provides  editing 
options . 

Syntax:  SHOW_FILE  -or- 

SHOF 

F  or  FILE=file 


T  or  TITLE=string 
W  or  WIDTH=integer 
X=integer 
Y=integer 

STATUS=status  variable 

Parameters:  T  -  (attribute:  BY_NAME) 

the  title  of  the  window 
(default:  T='Display  of  contents') 

W  -  (attribute:  BY_NAME) 

the  width  of  the  window  (characters) 

(default:  78;  range:  1-8G) 

X  -  (attribute:  BY_NAME) 

X-coordinate  of  the  upper  left-hand  corner  of 
the  window 

(default:  5;  range:  2-80) 

Y  -  (attribute:  BY_NAME) 

Y-coordinate  of  the  upper  left-hand  corner  of 
the  window 

(default:  5;  range:  2-30) 

Default  function  keys: 

Key  label  description 

OK  complete  comand  execution  (also  RETURN) 

Help  display  help  (EUM$SH_SHOW_FILE) 

Copy  copy  marked  lines  to  a  file 

(user  a  file  selection  window  having 
the  same  characetrist ics  as  the  window 
generated  by  GET_FILE_SELECTION) 

Edit  edit  the  file  using  EDIT_FILE 

Find  locate  text  in  the  display 

(a  dialog  window  prompts  you  for  the 
search  text) 

Mark  toggle  the  marking  of  the  current  line 

ExtMrk  extend  the  marking  (or  unmarking)  from 

the  last  mark  to  the  current  line 
SeeAll  return  to  the  SH0W_FILE  window  after 

f  ind 

Fwd  page  forward 

Bkw  page  backward 

First  go  to  first  line 

Last  go  to  last  line 
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Up 

put 

current 

line 

at 

top  of  screen 

Down 

put 

current 

1  ine 

at 

bottom  of  screen 

Examples:  /shof 

my  file 

SHOW_VALUE 

Display  a  value  in  a  pop  up  window. 

Syntax:  SHOW_VALUE  -or- 

SHOW_VALUES  -or- 
SHOV 

V  or  VALUE  or  VALUES=any 


DO  or  DISPLAY_OPTION  or 

DISPLAY_OPTIONS=keyword 
T  or  TITLE=string 
W  or  WIDTH=integer 
X=integer 
Y=integer 

STATUS=status  variable 
Parameters:  V  -  the  value  to  be  displayed 


Examples : 


DO  -  display  options 

ab  option 


CLE  COMPRESSED_LABELED_ELEMENTS 
E  ELEMENTS  or  ELEMENT 

LE  LABELED_ELEMENTS 

(default:  ELEMENTS) 

T  -  (default:  'Display  of  value') 

W  -  (default:  70;  range:  1-80) 

/v  =  154 
/shov  v 


|  154 

- Press  RETURN  to  continue 

/ 


SK.IP_TAPE_MARK 

Position  a  tape  backward  or  forward. 

Syntax:  SKIP_TAPE_MARK  -or- 

SKI P_TAPE_MARKS  -or~ 
SKITM 

F  or  FILE=f i 1 e 


D  or  DIRECTI0N=keyword 
C  or  C0UNT=integer 

STATUS=status  variable 
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SORT 


Parameters:  D  -  the  direction  to  skip 

dir  position  at  completion 


FORWARD  after  <count>  tapemarks 
BACKWARD  before  <count>  tapemarks 
(default:  FORWARD) 

C  -  the  number  of  tape  marks  to  skip 
(default:  1) 

Similar  commands:  NOS:  SKIPEI;  SKIPF;  SKIPFB;  SKIPR 

Examples:  /skip_tape_mark  file=mytape  count=4 

/skitm  mytape  forward  4 

A —  these  two  are  the  same 
/skitm  mytapel  d=backward 

A —  skip  backward  1  tapemark  on 
tape  MYTAPE1 


Sort  records  from  one  or  more  files  and  write  them  in  sorted 
order  to  a  single  output  file. 

Syntax:  SORT 


F 

or 

T 

or 

K 

or 

D 

or 

L 

or 

LO 

or 

E 

or 

EL 

or 

RP9 

or 

ENR 

or 

ERF 

or 

CC 

or 

OD 

or 

OFL 

or 

OMRL 

or 

OP1 

or 

OP2 

or 

OP3 

or 

0P4 

or 

OP5 

or 

R00 

or 

CSN 

or 

CSS 

or 

FR0M=1 ist  of  file 
T0=f ile 

KEY=list  of  list  of  range  of  any 

DIR  or  DIRECTIVES  or 

DIRECT I VES_F ILE  or  DF=list  of  file 

LIST=f ile 

LIST_OPTION  or 

LIST_OPTIONS=l ist  of  keyword 
ERR0R=f ile 
ERROR_LEVEL=keyword 
RESERVED_P0SITI0N_9=boolean 
ESTIMATED_NUMBER_RECORDS= range  of 

integer 

EXCEPTION_RECORD_FILE=f ile 
C170_C0MPATIBLE=boolean 
OMIT_DUPLICATIONS=boolean 
OWNFL  or  OWNCODE_FIXED_LENGTH= integer 
OWNCODE_MAXIMUM_RECORD_LENGTH= integer 
0WN1  or  OWNCODE_PROCEDURE_l=name 
OWN 2  or  0WNC0DE_PR0CEDURE_2=name 
OWN 3  or  0WNC0DE_PR0CEDURE_3=name 
0WN4  or  0WNC0DE_PR0CEDURE_4=name 
0WN5  or  0WNC0DE_PR0CEDURE_5=name 
RETAINER IGINAL_ORDER  or  RETAIN  or 
RET=boo 1 ean 

COLLATING_SEQUENCE_NAME  or 
SEQN=name 

COLLATING_SEQUENCE_STEP  or 
SEQ=list  of  rangeof  any 
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Parameters : 


CSR  or  COLLATING_SEQUENCE_REMAINDER  or 
SEQR=boolean 

CSA  or  COLLATING_SEQUENCE_ALTER  or 
SEQA=boolean 
STATUS=s tatus  variable 
S  or  SUM=list  of  list  of  range  of  any 
ZLR  or  ZERO_LENGTH_RECORDS=keyword 
VMIO  or  VERIFY_MERGE_INPUT_ORDER  or 
VERIFY  or  VER=boolean 
LCT  or  LOAD_COLLATING_TABLE=list  of  name 
RA  or  RESULT_ARRAY  or  RES=array  of  integer 

variables 

F  -  1  to  100  input  files 

(default:  SLOCAL.OLD) 

T  -  output  file 

(default:  NEW  or  $L0CAL.NEW1  owncode  3 
may  override  this) 

K  -  1  to  106  key  field  definitions: 

(first .. last , type, order)  -or- 
(f irst , length, type, order) 
param  meaning 


first  first  byte  of  key  field 

(leftmost  byte  is  numbered  1) 

last  last  byte  of  key  field 

length  number  of  bytes  in  key  field 
(default:  1) 

type  name  of  numeric  data  format  or 
collating  sequence 

numeric  formats 


BINARY 

INTEGER 

NUMERIC_FS 

NUMERIC_LS 

NUMERIC_TO 

PACKED 

REAL 


BINARY_BITS 

INTEGER_BITS 

NUMERIC_LO 

NUMERIC_NS 

NUMERIC_TS 

PACKED  NS 


collating  sequences 


ASCII  ASCI 16 

C0B0L6  DISPLAY 

EBCDIC  EBCDIC6 

(default:  ASCII) 
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order  sort  order 

A  (ascending) 

D  (descending) 

(default:  A) 

(default:  use  the  minimum  record  length 

(default:  0)  as  the  key  length) 

DF  -  1  to  100  directives  files 

(default:  the  merge  is  completely 
specified  in  the  command) 

LO  ~  list  options 
lo  meaning 

OFF  only  minimum  information 
NONE  same  as  OFF 

S  source  directives 

DE  detailed  exception  information 

(requires  EXCEPT I ON_RECORD_F I LE 
parameter) 

RS  record  statistics 

MS  merge  statistics 

(default:  minimum  information) 

EL  -  (I,  T,  W,  F,  C,  NONE) 

(default:  WARNING) 

RP9  -  reserved 

ENR  -  integer  1  thru  16,777,215 
(not  used  by  MERGE) 

ERF  -  invalid  records  are  written  to  this  file 
instead  of  the  output  file 
(default:  no  exception  processing  — 

invalid  records  are  written  to 
the  output  file) 

CC  _  YES  =>  convert  lowercase  letters  in  owncode 
routines  to  uppercase 
NO  =>  owncode  procedure  names  are  not 
converted 
(default:  NO) 

OD  -  control  processing  of  duplicate  records 
(those  with  matching  keys) 

YES  =>  duplicate  records  are  omitted 
NO  =>  duplicate  records  are  not  omitted 
(default:  processed  by  OWNCODE_ 

PROCEDURE_5 ,  RETAIN_0RIGINAL_ 
order,  or  SUM  parameter) 
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OFL 


integer  1  thru  4096 

(default :  OWNCODE_MAXIMUM_RECORD_LENGTH 
is  used) 

(this  or  OMRL  is  required  if  TO  or  FROM 
is  omitted) 


OMRL  -  integer  1  thru  4096 

(default:  the  record  length  attribute  of 
the  first  input  file  read  or 
output  file  written  is  used) 
(this  or  OFL  is  required  if  TO  or  FROM 
is  omitted) 

0P1  -  reserved 

OP2  ~  reserved 


OP3  ~  name  of  the  routine  to  process  each 
output  record 

(default:  no  user-defined  output  record 
postprocess ing) 


OP4  -  name  of  the  routine  which  can  insert  a 
record  at  the  end  of  the  output  file 
(default:  no  user-defined  output  file 
postprocessing) 


OP5 


name  of  the  routine  to  proces-  duplicate 
records  (having  equal  keys) 

(default:  no  user-defined  processing  of 
matching  records) 

(0P5  and  SUM  are  mutually  exclusive) 


R00  -  reserved 


CSN  - 


CSS  - 


name  of  the  collating  sequence  defined  by 
subsequent  collating  sequence  parameters 
(default:  no  user-defined  collating 
sequence) 

one  or  more  value  step  definitions  (value 
sets  each  defining  one  or  more  value  steps 
in  the  collating  sequence  (char  is  ASCII): 
('char') 

A —  one  1-character  value  step 
( ' char ' , ' char ',...) 

A —  one  multi-character  value  step 
( ' char ' . . ' char  ' ) 

A —  multiple  1-character  value  steps 
('char' . . 'char' , ' char' . . 'char'  ,  . .  .) 

A —  multiple  multi-character  value 
steps  (all  ranges  must  be  the 
same  size) 

(default:  no  specific  collating  sequence 
value  steps  are  defined) 


Page  H-158 


RevO 


90/09/30 


CSR  ~  TRUE  =>  a  special  value  step  is  defined 
containing  all  characters  not  in 
other  value  steps 

FALSE  =>  remaining  characters  keep  their 
ASCII  positions 
(default:  FALSE) 

CSA  -  TRUE  =>  all  characters  in  a  value  step 

are  changed  to  the  first  character 
in  the  value  step 
FALSE  =  >  no  character  alteration 
(default:  FALSE) 

S  -  1  thru  100  sum  field  definitions: 

(first.. last, type , repea t_count)  ~or- 
(f irs  t , length, type , repeat_count) 
param  meaning 


first  same  as  for  KEY 

last  same  as  for  KEY 

length  same  as  for  KEY 

type  name  of  numeric  data 

format  (same  as  for  KEY) 

repeatcount  number  of  consecutive 

sum  fields  defined  by  the 
value  set 
(def au! t :  1) 

(0P5  and  SUM  are  mutually  exclusive) 

ZLR  -  controls  the  disposition  of  zero-length 
records  read  from  input  files 
zlr  meaning 


DELETE  the  records  are  deleted  and  not 
written  to  the  exception  records 
file 

PAD  each  such  record  is  processed  as 

a  short  record 

LAST  each  such  record  is  written  at 
the  end  of  the  output  file 

VMI0  -  TRUE  =  >  check  that  r.  L 1  input  record?  are 
in  sorted  irder 

FALSE  =>  do  not  check  the  input  order 
(default:  FALSE) 

LCT  -  load  a  collating  table  (predefined  by 

NOS/VE  or  user-defined)  for  use  by  one  or 
more  keys: 

(key  type  name , co 1 1  a t ing  table  name) 
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RA  -  a  6-element  SCL  variable  for  the  return 
of  statistics  with  the  first  element 
defined  as  the  number  of  statistics  to  be 
returned  (0  thru  15) 

Similar  commands:  COS,  NOS,  VMS:  SORT 

Examples:  /sort  ($user . inf yl 1 , $user . infyl2) 

. . /Suser . outfyl 
. . /key=  (  (1 , 10) )  verify=yes 

A —  merge  files  infyll  and  infyl2 
producing  infyl3  —  leftmost 
10  characters  are  used  as  the 
key  —  the  sort  is  ascending 
ASCII  —  the  input  record 
sort  order  is  checked 


/ sort , key= ( (1 , 10)) 

A —  sort  columns  1-10  of  file 
SLOCAL.OLD  writing  file 
$L0CAL. NEW 


/sort  fyl4  fyl5  ( (9. . 16) , integer , d) , (3) ) 

A —  sort  using  two  keys:  columns 
9-16  contain  integers  and  are 
put  into  descending  order; 
column  3  contains  an  ASCII 
character  and  is  put  into 
ascending  order 


S0URCE_C0DE_UTILITY 

Begin  an  SCU  utility  session. 

Syntax:  SOURCE_CODE_UTILITY  -or- 

SCU  -or- 

SOUCU 


STATUS=status  variable 

Remarks:  Use  CREATE_LIBRARY  or  USE_LIBRARY  subcommands 

to  initialize  the  working  library  for  the  session. 
If  omitted,  SOURCE_LIBRARY  is  used  (or  created). 

Subcommand  prompt:  sc/ 

See  also:  Section  8-5 

Similar  commands:  COS,  NOS:  UPDATE 

VMS:  LIBRARY/TEXT 
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Examples:  /source_code_ut i 1 i ty 

sc/user_l ibrary  base=oldpl  resul t=oldpl . $next 
sc/ quit 

A —  creates  new  cycle  of  OLDPL  in 
your  working  catalog  (assumed 
not  to  be  $LOCAL) 


/scu 

sc/create_deck  deck  =  deckl  .  . 
sc. ,/modification=versionl 
sc/quit 

A —  initializes  the  working  library 
from  file  SOURCE_L IBRARY  in  your 
working  catalog 

STATUS_CRAY 

(DTRC)  Display  the  status  of  Cray  jobs. 

Syntax:  STATUS_C?.AY  -or~ 

STAC 


Q  or  QUEUE=list  of  key 
MF=name 

0  or  L  or  OUTPUT=file 

STATUS=status  variable 

Parameters:  Q  -  the  queue  to  be  displayed 

q  queue 


A  all 

E  execution 
I  input 
0  output 
R  receiving 
S  sending 
(default:  A) 

MF  -  the  NOS  mainframe 
(default:  MCR) 

See  also:  SUBMIT_CRAY_JOB 

Similar  commands:  NOS:  CSTATUS 

VMS:  CRAY  STATUS 

Examples:  /stac 

/stac  e 
/stac  ers 
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SUBMIT_CRAY_JOB 

(DTRC)  Submit  a  job  to  the  Cray. 

Syntax:  SUBMIT_CRAY_JOB  -or- 

SUBCJ 

FILE=file 


STATUS=s tatus  variable 

Parameters:  F  -  the  file  containing  the  Cray  job 

Remarks:  The  job  is  submitted  through  the  NOS  Cray 

station. 

By  default,  the  output  will  go  to  the  NOS  prin 
queue.  To  route  the  output  to  a  NOS/VE  file, 
dispose  $OUT  to  a  permanent  file  (see  second 
example) .  The  output  may  also  be  saved  as  an 
8/12  ASCII  NOS  file. 

See  also:  STATUS_CRAY 

Similar  commands:  COS:  SUBMIT 

NOS:  CSUBMIT 

VMS:  CRAY  SUBMIT;  CSUBMIT  (DTRC); 
RCSUBMIT  (DTRC) 

Examples:  /submit_cray_job  my_cray_j ob_l 

A —  output  printed  by  NOS 


File  MY_CRAY_J0B_2  contains: 

JOB , JN= j  obname . 

ACCOUNT, UN=user name, UPW=password,AB=j  oborderno 
DISPOSE , DN=$out , DC=ST, DEFER , WAITTEXT= , A 

' USER , username , password.CTASK,NVE.$outf ile$’ 

/subjc  my_cray_j ob_2 

A —  the  Cray  output  is  put  into 
NOS/VE  file  <outfile> 


SUBMIT_DETATCHED_JOB 

Start  a  disconnected  interactive  job. 

Syntax:  SUBMIT_DETATCHED_JOB  -or- 

SUBDJ 


UI  or  USER_INFORMATION=s tring 
STATUS=status  variable 

Parameters:  UI  -  a  0-  to  255-character  string  with 

information  for  the  detached  job 
(default:  ' '  -  a  null  string) 
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Remarks:  Validation  to  submit  detached  jobs  is  required. 

The  detached  job  acquires  the  user  name,  login 
family,  and  job  class  from  the  submitting  job. 


SUBMIT_JOB 

Submit  a  NOS/VE  batch  job. 


Syntax:  SUBMIT_JOB  -or- 

SUBJ 

i  or  riLc.-ii.le 


CTL  or  CPU_TIME_LIMIT=keyword  or  integer 

ERT  or  EARLIEST_RUN__TIME=date_t  ime 

JAD  or  JOB_ABORT_DISPOSITION=keyword 

JC  or  JOB_CLASS=name 

JDBU  or  JOB_DEFERRED_BY_USER=boolean 

JD  or  JOB  DESTINATION=name  or  string 

JDU  or  JOB_DESTINATION_USAGE=keyword  or  name 

JER  or  JOB_EXECUTION_R I NG= integer 

JQ  or  JOB_QUALIFIERS  or 

JOB_QUALIFIER=keyword  or  list  of  name 
JRD  or  JOB_RECOVERY_DISPOSITION=keyword 
LRT  or  LATEST_RUN_TIME=date_t ime 

LF  or  LOGIN_FAMILY=name 

MTL  or  MAGNETIC_TAPE_LIMIT=keyword  or  integer 

MAXWS  or  MAXIMUM_WORKING_SET=keyword  or  integer 

OF  or  OPERATOR_FAMILY=name 

OU  or  OPERATOR_USER=name 

RHD  or  REMOTE_HOST_DIRECTIVE=string 

SL  or  SRU_LIMIT=keyword  or  integer 

S  or  STATION=keyword  or  name 

UI  or  USER_INFORMATION=s tring 

UJN  or  USER_JOB_NAME  or  JN  or  JOB_NAME=name 
SJN  or  SYSTEM_JOB_NAME=name  variable  or 
list  of  name 
STATUS=s tatus  variable 


Remarks:  The  job  begins  with  LOGIN  and  ends  with  LOGOUT. 

See  also:  JOB 


Similar  commands:  NOS:  SUBMIT;  ROUTE 
VMS:  SUBMIT 
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Examples:  /colt  job_file 

ct?  login  login_user=abcd  . . 

password=mypass 
ct?  di sp) ay_command_l is t  all 
ct?  logout 
ct?  ** 

A —  create  the  job  file 
/subj  f=job_file  ujn=my_job 

A —  submit  the  job 
/disjs  jn=my_job  do=all 
Name  not  found  :  my_job 

A —  indicates  the  job  has  completed 


TABLEND  (UTILITY  subcommand)  End  the  collection  of  utility  command 
table  definitions. 

Syntax:  TABLEND 


TASK  Delimit  a  sequence  of  SCL  statements  to  be  as  a  synchronous 
or  an  asynchronous  task. 

Syntax:  TASK 


TN  or  TASK_NAME=name 
R  or  RING=integer 
DM  or  DEBUG_MODE=boo 1 ean 

SM  or  SUBSTITUTION_MARK=keyword  or  string 
STATUS=status  variable 

Parameters:  TN  -  causes  asynchronous  execution  and  identifies 

it  for  future  reference 
(default:  it  executes  synchronously) 

R  -  the  ring  number  (1-13) 

(default:  the  current  ring) 

SM  -  (substitution  marks  cannot  be  used  to 
generate  the  TASKEND  statement) 

TERMINATE_COMMAND 

Terminate  the  program  interrupted  by  a  pause  break  (7.1)  . 

Syntax:  TERMINATE_COMMAND  -or- 

TERC 


STATUS=status  variable 
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Subcommand  prompt:  p/ 

Similar  commands:  NOS:  %2 

VMS:  AY;  AC 

Examples:  Enter  new  password 

xxxxxxxxxxxxxxxxxxxx  < —  pause  break  entered 

’■Suspended  -  1* 

p/terminate_command 
Command  terminated. 

/ 

A —  you  decided  not  to  change  your 
password,  so  ym>  entered  a  pause 
break  (XI)  to  interrupt  it,  then 
typed  TERC  to  terminate  the 
command 


TERMINATE  JOB 


Terminate 

queued  or  executing 

j  obs . 

Syntax: 

TERMINATE  JOB 

-or- 

TERMINATE  JOBS 

-or- 

TERJ 

-or- 

TERMINATE  INPUT 

-or- 

TER  I 

N  or  NAME  or  NAMES  or  J0B_NAME  or 
JOB  NAMES  or  JN=list  of  name 


JS  cr  JOB_STATUS  or  STATE  or  S=keyword  or 
list  of  keyword 

ODI  or  OUTPUT_DISPOSITION=keyword 
STATUS=status  variable 

Parameters:  N  -  the  user-  or  system-supplies  names  of  the 

jobs  to  be  terminated 


JS 

-  states  for  restricting  termination 
ab  option  meaning 

D 

ALL  all  jobs 

DEFERRED  jobs  not  yet  eligible  to 

Q 

be  initiated 

QUEUED  jobs  waiting  to  be 

I 

initiated 

INITIATED  jobs  that  have  been 

T 

initiated 

TERMINATED  jobs  that  are  terminated 

ODI 

-  how 

the  output  is  to  be  discarded 

ab 

option 

DSO 

DISCARD  STANDARD  OUTPUT 

P 

PRINTER 

WQ 

WAIT  QUEUE 
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Remarks:  WHEN  conditions  are  not  processed. 

Similar  commands:  NOS:  DROP 

VMS:  DELETE/ENTRY 


TERMINATE_OUTPUT 

Delete  output  files. 


TERMINATE 

OUTPUT 

-or- 

terminate’ 

^OUTPUTS 

-or- 

TERO 

-or- 

TERMINATE 

PRINT 

-or- 

terminate’ 

’prints 

-or- 

TERP 

N  or  NAME  or  NAMES  or  J0B_NAME  or 
JOB  NAMES  or  JN=list  of  name 


OS  or  OUTPUT_STATUS=keyword 
STATUS=status  variable 


Parameters:  N  -  the  user-  or  system-supplies  names  of  the 

output  files  to  be  deleted 

OS  -  states  for  restricting  termination 
ab  option  meaning 


ALL 

D  DEFERRED 
Q  QUEUED 
I  INITIATED 
C  COMPLETED 


all  jobs 

jobs  not  yet  eligible  to 
be  printed 
jobs  waiting  to  be 
printed 

jobs  that  have  been 
printed 

jobs  that  have  printed 
but  are  still  in  the 
output  queue 


Similar  commands:  NOS:  DROP 

VMS:  DELETE/ENTRY 


TERMINATE_TASK 

Delete  asynchronous  tasks  (and  all  tasks  generated  by  those 
tasks) . 

Syntax:  TERMINATE_TASK  -or- 

TERT 

TN  or  TASK_NAME  or  TASK_NAMES=k eywor d  or 

list  of  name 


STATUS=s tatus  variable 
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Parameters:  TN  -  the  names  of  the  tasks  to  be  terminated 

ALL  -  all  tasks  initiated  by  the  requesting 
task 


TYPE  Create  one  or  more  user-defined  data  types. 

Syntax:  TYPE 

name  :  type  expression 

TYPEND 


UTILITY 

Delimit  the  definition  and  execution  of  a  command  utility. 


Syntax:  UTILITY 

N  or  NAME=name 


ESL  or  ENABLE_SUBCOMMAND_LOGGING=s tr ing 
IIP  or  INTERACT I VE_INCLUDE_PROCESSING=keyword 
or  name 

L  or  LIBRARY  or  LIBRARIES=list  of  file 
LP  or  LINE_PREPROCESSOR=keyword  or  name 
OM  or  INLINE_MANUAL=keyword  or  name 
P  or  PR0MPT=string 
SM  or  SEARCH_MODE=keyword 
T  or  TABLE  or  TABLES=f ile 
TCN  or  TERM I NAT I ON_COMMAND_NAME=name 
STATUS=status  variable 

Parameters:  N  -  the  name  of  the  utility 

ESL  -  YES  -  utility  subcommands  are  logged 

NO  -  utility  subcommands  are  not  logged 
(default:  YES) 


IIP  -  reserved 

L  -  the  object  library/ies  of  utility 
subcommand  processors 
(default:  the  library  containing  the 
ut i 1 i ty) 

LP  -  reserved 

OM  -  the  name  of  the  on-line  manual  describing 
the  utility  to  be  used  as  the  default  for 
the  MANUAL  parameter  of  the  HELP  command 
entered  from  within  the  utility 
NONE  -  no  on-line  manual 
(uefduit:  NONE) 
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VAR 


P  -  the  prompt  string 

("/"  or  "../"  is  added,  as  appropriate) 
(default:  the  utility  name) 

SM  _  the  command  search  mode  used  for  the  utility 
ab  option  meaning 


G 


R 


E 


GLOBAL 


RESTRICTED 


EXCLUSIVE 


all  commands  in  the  command 
list  can  be  searched  - 
commands  specified  by 
command  name  or  file 
reference  can  be  executed 
like  G,  except  searching 
beyond  the  first  entry  in 
the  command  list  requires 
a  slash  (/)  before  the 
command 

only  the  first  entry  in 
the  command  list  is 
searched  -  commands 
specified  by  command  name 
or  file  reference  are  not 
allowed 


(default:  GLOBAL) 


T  -  the  file  with  the  table  of  utility 

subcommands  defined  by  the  COMMAND  command 
(default,  y  COMMAND) 


TCN  -  the  utility  subcommand  used  to  terminate 
the  utility 
(default:  QUIT) 


Create  one  or  more  variables. 

Syntax:  VAR 

name:  (attributes)  type  expression  =  initial 

value 

VAREND 

Parameters:  attributes  -  general  (either  or  both): 

READ  -  variable  cannot  be  modified 
(an  initial  value  is 
required) 

DEFER  -  evaluate  the  expression 
when  the  variable  is 
referenced 
scope  (only  one) : 

LOCAL,  XDCL ,  XREF,  ENVTRONAL.L'T, 

JOB,  TASK,  UTILITY,  PUSH 
(default:  LOCAL) 
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WAIT 


WHEN 


init  value 


(defaults:  boolean:  TRUE 
integer:  0 

list:  0  (empty  list) 

real :  0.0 

status:  NORMAL  field=TRUE 

string:  ' '  (null  string)) 


Suspend  command  processing  for  a  time  period  or  until  an  event. 


Syntax:  WAIT 


T  or  TIME=integer  or  t ime_increment 
TN  or  TASK_NAME  or  TASK_NAMES=1 ist  of  name 
QN  or  QUEUE_NAME  or  QUEUE_NA_MES=  1  ist  of  name 
U  or  UNT I L=keywor d 

STATUS=status  variable 

Parameters:  T  -  number  of  milliseconds  to  wait 

(default:  no  wait) 


TN  -  the  tasks  to  complete  before  resuming 

QN  -  the  job  queues  from  which  a  message  must  be 
received  before  resuming 

U  -  how  many  of  the  events  must  occur 
option  meaning 

ANY  any  of  the  specified  events 

ALL  all  of  the  specified  events 

(default:  ANY) 


Similar  commands:  VMS:  WAIT 


Examples:  /wait  20000  < —  wait  20,000  milliseconds  (20 

seconds) 


Delimit  SCL  statements  to  be  executed  when  a  specified 
condition  occurs. 

Syntax:  WHEN  condition  names  DO 

statement  list 
WHENEND 

SCL  functions:  OSV$STATUS  -  initialized  by  the  program 

that  determined  the 
condition 
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WHILE 


WHO 


OSV$COMMAND_NAME  -  the  name  of  the  command 

being  processed 

See  also:  EXIT 

Similar  commands:  VMS:  ON 


Conditionally  repeat  a  statement  list. 

Syntax:  label:  WHILE 

boolean  expression  DO 
statement  list 
WHILEND  label 

Parameters:  label  -  the  name  of  the  WHILE  block  -  may  be 

used  by  CYCLE  or  EXIT 

bool_exp  -  the  terminating  condition 

Subcommand  prompt:  while/ 

Similar  commands:  NOS:  WHILE,  ENDW 

VMS:  DO  WHILE 


(DTRC)  List  the  executing  jobs,  including  users  currently 
logged  in. 

Syntax:  WHO 

Remarks:  WHO  displays  the  following  information: 

CPU  Idle:  <idle>/<i/o> 

-  CPU  has  been  idle  <idle>7.  of  the  time 
since  the  last  display  --  of  that,  <i/o>7. 
was  waiting  for  I/O  to  complete,  and 
<idle>-<i/o>7.  was  waiting  for  events  such 
as  timed  or  interactive  input 

NOS:  <exec> 

-  CPU  has  been  executing  NOS  <exec>7.  of  the 
time  since  the  last  display 

For  each  job: 

SSN  -  the  system-supplied  name  for  the  job 

UJN  -  the  user-supplied  job  name  (first  8 
characters 

C  -  the  service  class 
class  meaning 


B  batch 

I  interactive 

M  maintenance 

S  system 
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S  -  the  job  status 

status  meaning 

blank  job  is  swapped  out  because  it 
is  in  a  long  wait 

D  job  is  swapped  out  because  of 

its  dispatching  priority 
(higher  priority  jobs  are 
CPIJ-bound) 

F  job  is  swapped  due  to  an 

operator  request 

I  job  is  being  swapped  into 

memory 

L  job  is  swapped  out  due  to  an 

IDLE_SYSTEM  command 

M  job  is  in  memory 

P  job  is  swapped  out  due  to  low 

priority 

T  job  is  swapped  out  because  of 

thrashing 

U  job  is  swapped  out  for  other 

reasons 

PR  -  the  job  scheduling  priority  ( / 1 00) 

If  the  C,  S,  and  PR  fields  are  asterisks,  the 
system  has  forced  the  job  out  due  to  a  system  or 
hardware  failure.  The  job  is  dead  and  cannot  be 
continued. 


Similar  commands:  NOS:  WHO 

VMS:  SHOW  USERS 


Examples  : 


/  who 

SSN  UJN  C  S  PR 

CPU  Idle:  43/20  NOS:  46 


$0860_0488_AAA_0000  $SYSTEM  S 
$0860_0488_AAM_0010  MAiLVESS  B 
$0860_0488_AAL_4002  HPA_VE$P  M 
$0860_0488_AAM_008 1  CACO  I 
$0860_0488_AAM_0079  AMDS  I 


M  0 


M  170 

two  columns 
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WHOAMI  (DTRC)  Display  the  executing  user's  username  and  job  order 
number . 

Syntax:  WHOAMI 


STATUS=s tatus  variable 

Similar  commands:  NOS:  BEGIN, WHOAMI 

VMS:  MYACCOUNT 

Examples:  /whoami 

Login_Pro j ect  :  $1222233344 
Login_User  :  ABCD 


XEROX  (DTRC)  Print  a  NOS/VE  file  on  the  Xerox  8700. 

Syntax:  XEROX 

F  or  FILE=f ile 


C  or  COPIES=integer 
J  or  JOB=keyword 
P  or  PAPER=keyword 
D  or  DUPLEX=keyword 
FO  or  F0RMS=kevword 
S  or  SHIFT=integer 
U  or  UJN=name 

STATUS=status  variable 

Parameters:  F  -  the  file  to  be  printed  on  Xerox 

C  -  the  number  of  copies  (1-999) 

(default:  1) 

J  -  job  on  Xerox  to  process  the  file 

(in  the  following:  CC=carriage  control 


character 
j  ob 

,  L« 
L/P 

landscape 

width 

,  P=portrait) 
lines  description 

STDLND 

L 

CC+136 

62 

std  L  job 

STDPRT 

P 

CC+72 

62 

std  P  job 

ST3PRT 

P 

CC+94 

62 

3rd  std  P  job 
(very  large 
margins) 

ST4PRT 

P 

CC+87 

62 

4th  std  P  job 

(general 

documentation; 

manuals) 


DOCPRT  P  CC+87  62  ST4PRT  with 

in  col  76  to 
force  new  side 
66  like  ST4PRT 

with  blank  CC 
and  exactly  66 
lines  per  page 


VAX DOC  P  CC+87 
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S2UPPRT 

P 

CC+136 

12A 

2  std  L 

$2UCPRT 

P 

CC+136 

132 

arranged 
vertical  ly 
like  52UPPRT 

LN8LND 

L 

CC+136 

84 

but  continuous 
(good  for 
printer  plots) 
8  lpi  L 

$2U8PRT 

P 

CC+136 

168 

$2UPPRT  at 

$2ACLND 

L 

2* (CC+72) 

62 

8  lpi 

2  std  P 

(Default : 

the  kind 

P 

STDLND) 

of  paper  to 
meaning 

be  used 

arranged  L 

$3_H0LE  3-hole  punched 
PLAIN  unpunched 


(Default:  $3_H0LE) 

D  -  specify  one-  or  two-sided  printing 
d  meaning 

DUPLEX  (D,  YES,  YE,  Y)  two-sided 
SIMPLEX  (S,  NO,  N)  one-sided 

(Default:  YES)  (two-sided) 

FO  -  specify  the  forms  overlay  to  be  used 

(in  the  following:  CC=carriage  control 
character,  L=landscape,  P=portrait) 
fo  L/P  description 


NONE  no  special  forms  overlay 

FRAME1  L  box  around  page  -  1  solid  line 

FRAME2  L  box  around  page  -  2  solid  lines 

FRAME3  L  box  around  page  -  3  solid  lines 

FRAME4  L  box  around  page  -  1  solid/ 

shaded  line 

S2UPL1  L  solid  line  dividing  2  pages 
$2UPB1  L  solid  boxes  around  2  pages 

S2UPL2  L  double  solid  lines  dividing  2 

pages 

FRAMP1  P  box  around  page  -  1  solid  line 

FRAMP2  P  box  around  page  -  2  solid  lines 

FRAMP3  P  box  around  page  -  3  solid  lines 

FRAMP4  P  box  around  page  -  1  solid/ 

shaded  line 

$2UP3L  p  triple  solid  lines  dividing  2 
pages 

$2UPSL  P  single  shaded  line  dividing  2 
pages 
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S2UPSB  P 
$2UPB2  P 

WEEKLY  P 


shaded  bar  dividing  2  pages 
2  separate  solid  line  boxes  on 
a  page 

checklist  by  days 


(Default:  NONE) 


S  -  specifies  whether  the  file  is  to  be  shifted 
one  column  to  the  right  before  printing 
s  meaning 

0  no  shifting  -  the  file  already  has 

Fortran  carriage  control  characters  in 
column  1  of  each  line 

1  the  file  does  not  have  Fortran  carriage 
control  in  column  1  and  will  be  shifted 
one  column  to  the  right  to  produce  a 
single-spaced  listing 

U  -  NOS  jobname  for  the  output 

(up  to  7  alphanumeric  characters,  first  4 
should  be  User  Initials) 

(default:  your  user  initials) 

XEROX  passes  the  parameters  to  the  BEGIN, XEROX 
command  on  NOS.  It  does  this  via  a  NOS/VE  batch 
job  which  it  creates. 


You  can  monitor  the  jobs  with  DISPLAY_JOB_STATUS 
(DISJS) .  When  it  completes,  the  dayfiles  will  be 
in  files  XER0X_DAY F I LE_VE  and  XER OX_DA Y F I LE_N 0 S , 
respectively.  If  you  execute  XEROX  more  than 
once,  additional  cycles  of  these  files  will  be 
created. 


Similar  commands:  NOS:  BEGIN, XEROX  (DTRC) 

VMS:  XEROX  (DTRC) 

Examples:  /xerox  my_output  j=st4prt  ujn=amdsxyj 


XMODEM_RECEIVE 

Receive  a  file  send  from  a  PC  using  XMODEM. 

Syntax:  XMODEM_R  ECE I V  E  -or- 

XMOR 

FN  or  FILE_NAME=f ile 
FT  or  FILE_TYPE=keyword 


EC  or  ERROR_CHECKING=keyword 
FM  or  FILE_MARKERS=keyword 
TF  or  TRACE_F I LE=  file 

STATUS=status  variable 
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Parameters : 


FN  ~  the  name  of  the  NOS/VE  file 

FT  -  the  type  of  file 

ab  option  meaning 


file  is  transferred 
line  by  line  (for 
standard  text  files) 
file  is  transferred 
character  by  character 
(for  microbinary  files) 
file  is  transferred 
character  by  character, 
and  the  file  label  and 
length  previously  saved 
are  used  to  restore  the 
file  attributes  and 
exact  file  length  - 
assumed  file  was 
originally  sent  to 
microcomputer  using  a 
NOS/VE  file  transfer 
(for  object  binary, 
binary,  or  NOS/VE 
backup  files) 

EC  ~  error  checking  method  to  be  used 
ab  option  meaning 


C  CHECKSUM 

CRC  or  CC  CCITT_CRC 

(default:  the  value  of  XMD$XM0R_ERR0R_ 

CHECKING  (if  it  exists)  or  CRC) 

FM  ~  specify  file  markers  for  TEXT  file  transfers 
option  meaning 

NOS/VE  //EOR  -  end-of-partition 

//E0I  -  end-of-information 
MSDOS  #E0R  -  end-of-partition 

AZ  -  end-of-information 
(default:  the  value  of  XMD$XMOR_FILE_ 

MARKERS  (if  it  exists)  or  $NULL) 

TF  -  the  file  to  receive  a  trace  showing  a 

hexadecimal  dump  of  every  protocol  block 
(default:  the  value  of  XMD$XMOR_TRACE_ 

FILE  (if  it  exists)  or  $NULL) 


T  TEXT 

BS  BYTE_STREAM 

NVE  NV  or  NOS  VE 


Similar  commands:  NOS:  XMODEM 
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XMODEM_SEND 

Send  a  file  to  a  PC  using  XMODEM. 

Syntax:  XMODEM_SEND  -or- 

XMOS 

FN  or  FILE_NAME=f ile 
FT  or  FILE_TYPE=keyword 


PS  or  PACKET_SIZE=keyword  or  integer 
ELS  or  END_LINE_SEQUENCE=keyword 
FM  or  FILE_MARKERS=keyword 
TF  or  TRACE_FILE=f ile 

STATUS=status  variable 

Parameters:  FN  -  the  name  of  the  NOS/VE  file 

FT  -  the  type  of  file 

ab  option  meaning 


TEXT  file  is  transferred 

line  by  line  (for 
standard  text  files) 
BYTE_STREAM  file  is  transferred 

character  by  character 
(for  microbinary  files) 
NV  or  NOSVE  file  is  transferred 

character  by  character, 
and  the  file  label  and 
length  are  included  to 
preserve  the  file 
attributes  and  exact 
file  length  for  later 
trasnsfer  back 
(for  object  binary, 
binary,  or  NOS/VE 
backup  files) 

PS  -  the  packet  data  field  size 
ps  meaning 

128 

1024 

SMALL  same  as  128 
LARGE  same  as  1024 

(default:  the  value  of  XMD$XM0S_PACKET_ 

SIZE  (if  it  exists)  or  128) 

ELS  -  the  character  sequence  signalling  end-of- 
line  for  text  files 
option  meaning 


CR  carriage  return 

CRLF  carriage  return  and  line  feed 

(usually  for  MSDOS) 

(default:  the  value  of  XMD$XM0S_END_L I NE 
SEQUENCE  (if  it  exists)  or  CR) 


T 

BS 

NVE 
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FM  -  specify  file  markers  for  TEXT  file  transfers 
option  meaning 

NOS/VE  //EOR  -  end-of-partition 

// EOI  -  end-of-inf ormation 
MSDOS  //EOR  -  end-of-partition 

AZ  -  end-of-inf ormation 
(default:  the  value  of  XMD$XMOS_FILE_ 

MARKERS  (if  it  exists)  or  $NULL) 

TF  -  the  file  to  receive  a  trace  showing  a 

hexadecimal  dump  of  every  protocol  block 
(default:  the  value  of  XMD$XMOS_TRACE_ 

FILE  (if  it  exists)  or  $NULL) 

Similar  commands:  NOS:  XMODEM 


YMODEM_RECEIVE 

Receive  a  file  send  from  a  PC  using  XMODEM  extention  YMODEM. 


YMODEMSEND 

Send  a  file  to  a  PC  using  XMODEM  extention  YMODEM. 
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*****  Appendix  I  ***** 

***  CDC  NOS  JCL  Commands  *** 

CDC  NOS  job  control  language  (JCL)  commands  have  the  following 
general  syntax: 

verb,paraml ,param2, . . . .  comments 

verb (paraml ,param2 , . . . )  comments 

verb  is  the  name  of  the  routine  to  be  executed.  It  consists  of  an 
alphabetic  character  (A~Z)  followed  by  0~6  alphanumeric 
characters  for  the  name  of  the  command. 

parami  are  parameters,  which  may  be  positional  or  keyword. 

comments  follow  the  terminator  (a  period  or  right  parenthesis  ") ") . 

***  Strings  *** 

The  following  string  representations  are  used  in  this  appendix: 


aa.  . 

.  a 

1 

or 

more 

alphabetic  characters 

axx . 

.  .  X 

1 

or 

more 

alphanumeric  characters,  the  first  alphabetic 

XXX  . 

.  .  X 

1 

or 

more 

alphanumeric  characters 

nn  •  i 

.  n 

1 

or 

more 

decimal  (unless  otherwise  stated)  digits 

nn.  . 

•  nB 

1 

or 

more 

octal  digits 

nn.  . 

.nD 

1 

or 

more 

decimal  digits 
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***  Some  Common  Parameters  *** 

The  following  parameters  are  used  in  many  JCL  commands.  If  they 
have  a  different  meaning  or  a  special  condition,  it  will  be  mentioned 
in  the  individual  description. 

CM=nnnnnn  Maximum  central  memory  field  length,  octal  unless  D  suffix 
or  8  or  9  in  number,  maximum  376500 

CT=ct  File  permit  Category  Type 

ct  meaning 


P  or  PR  or  PRIVATE  private 

S  or  SPRIV  semiprivate 

PU  or  PUBLIC  public 

JSN=jsn  Job  Sequence  Name  (aaaa) 

lfn  Local  File  Name  (xxxxxxx,  7  maximum) 

(lfn's  starting  with  ZZ  are  reserved  to  NOS) 

lfn_in  Input  local  file  name 

(normal  default  is  INPUT) 

lfn_out  Output  local  file  name 

(normal  default  is  OUTPUT) 

L=lfn  Output  listing  file  (xxxxxxx,  7  maximum) 

(normal  default  is  OUTPUT) 

M=m 

ro  File  permissions  (file  access  mode) 

m  meaning 

E  (EXECUTE)  you  can  execute; 

others  can  read  or  execute  concurrently 
R  (READ)  all  can  read  or  execute  concurrently 

RU  (READUP)  all  can  read  or  execute; 

one  (other)  user  can  rewrite  the  file 
RA  (READAP)  all  can  read  or  execute; 

one  (other)  user  can  lengthen  the  file 
RM  (READMD)  all  can  read  or  execute; 

one  (other)  user  can  lengthen  or  rewrite 
the  file 

U  (UPDATE)  all  can  read  or  execute; 

you  can  rewrite  the  file 
A  (APPEND)  all  can  read  or  execute; 

you  can  lengthen  the  file 
M  (MODIFY)  all  can  read  or  execute; 

you  can  lengthen  or  rewrite  the  file 
W  (WRITE)  you  can  read,  execute,  lengthen,  rewrite, 

or  shorten  the  file; 
others  have  no  concurrent  access 
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NA 

non-null 

pfn 

PW=password 
U JN^u j n 
UN=un 


No  abort  on  errors 

Indicates  that  the  parameter  the  presence  of  a  string  of 
characters  (normally  xxxxxxx,  7  maximum) 

Permanent  File  Name  (xxxxxxx,  7  maximum) 

(normal  default  is  the  lfn) 

password  for  access  to  another  user's  permanent  file 
User  Job  Name  (xxxxxxx,  7  maximum) 

User  Name  (xxxxxxx,  7  maximum) 
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***  Summary  o£  CDC  NOS  JCL  Commands  *** 

The  following  are  NOS  JCL  statements,  except  as  indicated  by: 

(DTRC)  A  command,  procedure  or  program  added  at  DTRC 

(IAF)  InterActive  Facility 

(ICF)  Interactive  Cray  Facility  (ICF) ; 

begin  with  a  slash  (/) ,  not  to  be  confused  with  the  IAF  prompt 

JCL  statements  for  certain  NOS  features  are  indicated  by: 

(CRM)  Cyber  Record  Manager 

(Loader)  Loader  control  statements 


Entire  line  is  a  comment. 

Syntax:  ’'comment 

See  also:  COMMENT 

Similar  commands:  COS:  * 

VMS:  ! 

Examples:  *  This  is  a  comment 


ct  1 


(IAF)  Interrupt  the  current  job  step  (user-break-1). 

Syntax:  ctl 

Parameters:  ct  -  the  network  control  character 

(normally  percent  (*/.)) 

Remarks:  Some  terminals  require  that  AS  be  entered  before 

and  AQ  after  this  command. 


Examples:  71 


ct2  (IAF)  Terminate  the  current  job  step  (user-break-2);  cancel 

the  output  in  progress. 

Syntax:  ct2 

Parameters:  ct  -  the  network  control  character 

(normally  percent  00) 

Remarks:  Some  terminals  require  that  AS  be  entered  before 

and  AQ  after  this  command. 


Examples : 


7.2 
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ctD 


ctE 


ctS 


ACCESS 


(IAF)  Immediately  detach  a  terminal  job  from  the  terminal. 
Syntax:  ctD 

Parameters:  ct  -  the  network  control  character 

(normally  percent  (7.) ) 

Remarks:  To  detach  during  output,  interrupt  the  output, 

then  enter  ctD. 

Any  type-ahead  commands  are  discarded. 
Examples:  7.D 


(IAF)  Immediate  detailed  job  status. 

Syntax:  ctE 

Parameters:  ct  -  the  network  control  character 

(normally  percent  (7)) 

Examples:  7E 


(IAF)  Immediate  abbreviated  job  status. 

Syntax:  ctS 

Parameters:  ct  -  the  network  control  character 

(normally  percent  (%)) 


Remarks : 


Examples : 


Response  is  one  of:  EXECUTE,  IDLE  (waiting  for 
you) ,  or  WAIT  (waiting  for  system  resources) . 


7.S 


(IAF)  Select 

the  ACCESS  subsystem. 

Syntax : 

ACCESS 

Remarks : 

Required  to  communicate  with  another  interactive 
terminal  (DIAL,  WHATJSN) 

RUN  will  not  work  in  the  access  subsystem. 

Examples : 

ACCESS 

WHATJSN 

DIAL, jsn, mess age 

BATCH  < —  reset  yourself 
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APPEND  Append  information  to  the  end  of  an  indirect  file  without 
retrieving  the  file. 

Syntax :  APPEND, pfn , 1 fn_l , 1 f n_2 , . . . , 1 fn_n/UN=un, PW=pw , 

NA, WB. 

Parameters:  UN=un  -  required  only  for  files  in  another 

catalog 

PW=pw  -  Required  for  files  with  passwords  in 
another  catalog 

WB  -  wait  for  a  busy  file 

Remarks:  You  cannot  append  to  a  direct  file. 

You  cannot  append  to  a  direct  access  (random) 
file. 

Similar  commands:  VMS:  APPEND 
Examples :  APPEND, my perm, new 1 , nu2 . 

APPSW  (IAF)  Switch  temporarily  to  an  altername  NAM  application 
program. 

Syntax:  APPSW, AP=appl ,2. data 


APPSW, appl ,Z,data 

Parameters:  appl  ~  a  NAM  application 

appl  meaning 

ICF  Interactive  Cray  Facility 
RBF  Remote  Batch  Facility 

Z  -  any  characters  following  the  terminator 

are  passed  to  the  secondary  application  as 
data 

data  -  first  50  characters  after  the  terminator 
are  passed  to  the  secondary  application 

Examples:  APPSW, ICF.  < —  go  into  Cray  Interactive  Facility 
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ASCII 


(IAF)  Set  terminal  to  ASCII. 


Syntax : 
Remarks : 

See  also: 
Examples : 


ASCII 

ASCII  support  is  128  characters  (95  graphics  plus 
33  controls)  in  6/12-bit  display  code. 

CSET ,  NORMAL 

ASCII 


ASSIGN  Assign  a  file  to  a  device. 


Syntax:  ASSIGN, nn, lfn, ckpt . 


Parameters:  nn 


device 

type 

or  device  type  for  assignment 
equi pment 

MS 

mass  storage  device  (a  disk) 

MT 

7-track  magnetic  tape 

NE 

null  equipment 

NT 

9-track  magnetic  tape 

TT 

interactive  terminals 

(only  interactive  origin  jobs) 

lfn  -  the  file  to  be  assigned 


ckpt  -  lfn  is  to  be  a  checkpoint  file 
ckpt  meaning 


CK  put  each  dump  at  end  of  lfn 

CB  put  each  dump  at  beginning  of  lfn 


See  also:  FILE 


Similar  commands:  COS:  ACCESS 

NOS:  REQUEST_TERMINAL 


Examples : 

ASSIGN, MS, OUTPUT. 

<--  direct  output  to  a  disk 
file  until  returned  or 
reassigned 

ASSIGN, TT.XYZ. 

< —  assign  file  XYZ  to 
your  terminal 
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ATTACH  Assign  a  direct  permanent  file  to  a  job. 

Syntax :  ATTACH ,lfn_l=pfn_l,l f n_2=pf n_2 , . . . , 1 fn_n=pfn_n 

/M=m , UN=un ,PW=pw,NA,RT,WB. 

Parameters:  lfn_i=pfn_i  -  if  lfn_i  is  omitted,  pfn_i  is  used; 

if  lfn_i  exists,  it  is  discarded 

M=m  -  (default:  M=READ) 

UN=un  -  required  for  a  file  in  another  catalog 
PW=pw  -  required  if  UN  is  specified  and  the  file 
has  a  password 

RT  -  real-time  processing  (job  continues  after 
requesting  staging  from  the  MSS  -  a 
second  ATTACH  is  required  to  access  the 
staged  file;  if  no  staging  is  necessary, 
the  file  is  assigned  immediately) 

WB  -  wait  for  a  busy  file 

See  also:  GET,  FETCH  (Cray) 

Similar  commands:  COS:  ACCESS;  ACQUIRE 

NOS/VE:  ATTACH_FILE 

VMS:  no  local  file  concept 

Examples:  ATTACH, MYFILE/M=W. 

A —  allows  file  MYFILE  to  be 
overwritten  (such  as  after 
edit ing) 

AUX  (DTRC)  Turn  an  auxiliary  printer  on  or  off,  send  control  codes 

to  control  character  size  and  to  eject  a  page. 

Syntax:  BEGIN, AUX, , OPT. 

Parameters:  OPT  -  option: 

On/off: 

ON  -  turn  the  auxiliary  printer  on 

OFF  -  turn  the  auxiliary  printer  off 

Character  size  (Brother  2024L) : 

BCC  -  set  to  condensed  characters 

BCCOFF  -  turn  off  condensed  characters 

BEC  -  set  to  Elite 

BPC  -  set  to  Pica 

BWC  -  set  to  wide  characters 

BWCOFF  -  turn  off  wide  characters 

(also  turned  off  by  an  LF) 
Character  size  (Okidata  MicroLine  82  or  84 
OC132  -  set  Okidata  MicroLine  82  or  84 

printer  to  132  characters 
OC80  -  set  Okidata  MicroLine  82  or  84 
printer  to  80  characters 
Page  eject: 

TOP  -  go  to  the  top  of  the  next  page 
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Remarks:  At  present,  only  the  Brother  2024L  and  Okidata 

82  and  84  printers  (and  any  others  which  use  the 
same  control  sequences)  are  supported. 

See  also:  AUXPRINT 

Similar  commands:  VMS:  AUX 

Examp 1 es :  BEGIN , AUX , , ON . 

A —  turn  printer  on 

CATLIST.  < —  get  hard  copy  of  catalog  listing 

BEGIN, AUX, , OFF. 

A —  turn  printer  off 

AUXPRNT  (DTRC)  Print  a  file  on  an  auxiliary  printer. 

Syntax:  BEGIN, AUXPRNT, , LFN.OPT , TOP . 

Parameters:  LFN  -  the  file  to  be  printed 

OPT  -  optior  (Character  size): 

Brother  2024L: 

BCC  -  condensed  characters 

BEC  -  Elite 

BPC  -  Pica 

BWC  -  wide  characters 

Okidata  MicroLine  82  or  84: 

OC132  -  132  characters 

OC80  -  80  characters 

TOP  -  non-null  -  eject  page  after  printing  the 
file 

null  -  leave  the  printer  as~is  after 
printing  the  file 

Remarks:  At  present,  only  the  Brother  2024L  and  Okidata 

82  and  84  printers  (and  any  others  which  use  the 

same  control  sequences)  are  supported. 

See  also:  AUX 

Similar  commands:  NOS/VE,  VMS:  AUXPRINT 

Examples:  BEGIN, \UX?RNT, .rayfile, ,X. 

A —  print  file  MYFILE,  then  skip  to 
new  page 

BEGIN, AUXPRNT, ,myf ile.BEC. 

A —  print  file  MYFILE  in  Elite  on  a 
Brother  2024L 

BEGIN, AUXPRNT, ,myf i 1 e , 0C132 , TOP . 

A —  print  file  myfile  in  condensed 
characters  on  an  Okidata 
MicroLine  82,  then  eject  a  page 


Page  I- 10 


RevO 


90/09/30 


BASIC 


(IAF)  Select 


the  BASIC  subsystem. 


Remarks : 


Use  FSE  and  X, BASIC. 


BASIC  See  X, BASIC  to  compile  a  BASIC  program  without  entering  the 
BASIC  subsystem. 


BATCH 


(IAF)  Select 
Syntax : 
Parameters : 

Remarks : 
Examples : 


the  BATCH  subsystem. 

BATCH, fl 

fl  -  initial  running  field  length  for  subsequent 
commands 
(default:  0) 

This  is  the  default  subsystem  when  you  enter  IAF. 
BATCH 


BEGIN  Transfer  control  to  a  procedure. 


Syntax: 

BEGIN, pname, pfile, pi ,p2, . . . , pn. comment 

(1) 

-pname ,pfile,pl,p2,...,pn. comment 

(2) 

pname, pi , p2, . . . , pn. comment 

(3) 

pfile, pi, p2, . . . ,pn. comment 

(4) 

Parameters:  pname  -  the  name  of  the  procedure  to  be  executed 

(default:  the  procedure  at  the  current 
position  in  the  file) 

pfile  -  the  file  containing  the  procedure 
(default  search  order: 

1)  local  file  PROCFIL 

2)  your  permanent  file  PROCFIL 

3)  public-access  procedure  file 
PROCFIL/UN=LIBRARY) 


(note:  if  you  have  a  local  or  permanent 
file  PROCFIL,  you  cannot  access 
any  of  the  public  procedures, 
therefore,  use  another  filename 
for  your  procedures) 

pi  -  an  optional  parameter 

comment  -  value  associated  with  the  CK  keyword  in 
the  procedure  header 
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Remarks:  Except  for  interactive  execution  of  a  procedure, 

the  BEGIN  statement  may  be  continued  on  more  than 
one  line. 

For  interactive  procedures,  a  question  mark  "?" 
may  be  used: 

.  for  a  list  of  parameters: 

BEGIN, pname.pfile, ? 

.  for  help  with  a  parameter: 

BEGIN, pname ,pfile,pl, . . . ,pi? 

.  for  help  during  interactive  processing: 
param? 

To  accept  the  default  value  for  a  parameter 
during  interactive  processing,  press  the  carriage 
return. 

To  accept  the  default  value  for  the  current  and 
all  remaining  parameters,  enter  a  terminator.  If 
any  required  parameters  remain  undefined,  you 
will  be  prompted  for  them. 

See  also:  REVERT 

Similar  commands:  COS:  CALL 

NOS/VE:  filename 
VMS:  @f ilename 

Examples :  GET , MYPF, MYPROCFILE/UN=xxxx . 

BEGIN, MYPROC.MYPF. 

* —  a  user  procedure 

BEGIN, NEWCHRG. 

A —  a  public-access  procedure  in 
PROCFIL/UN=LIBRARY 


BELOAD  Selectively  load  files  from  a  NOS/BE  tape  created  by  DUMPF  or 

BEGIN, SELDUMP. 

Syntax:  BELOAD, 1=1 fni ,L=lfnl , T=lfnt , 0P=op. 

Parameters:  1=  -  input  file  of  directives 

(default:  INPUT) 

T=  -  local  file  name  of  the  tape 
(default:  TAPE) 

0P=  -  load  option  for  directives  with  PF= 
op  meaning 

N  normal  restore  (don't  replace 
existing  file) 

R  replace  specified  file  if  it  already 
exists 
(default:  N) 
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Directives:  ID=id,FN=fn,PF=nospf ,UN=un,CY=cy,CT=ct ,TY=ty, 

PW=pw,M=m. 

ID=  -  the  NOS/BE  ID  (required) 

FN=  -  the  NOS/BE  filename 
(also  requires  PF=) 

PF=  -  the  NOS  filename  (consisting  of  letters 
and  digits  only!) 

UN=  -  NOS  username  (required  if  the  NOS/BE  ID  is 
not  your  user  ID) 

CY=  -  the  NOS/BE  cycle  number 

(default:  the  highest  cycle  only) 

TY=  -  the  NOS  file  type 
ty  meaning 

D  direct 
I  indirect 
(default:  D) 

PW=  -  the  NOS  password  for  the  file 
M=  -  the  NOS  access  mode 
(default:  R) 

Remarks:  BELOAD  is  in  library  BETONOS/UN=LIBRARY . 

Similar  commands:  VMS:  BACKUP 

Examp 1 es :  ATTACH , BETONOS/UN=LIBRARY. 

LIBRARY, BETONOS/A. 

LABEL , TAPE , VSN=NA9876 , D=GE , F=S , LB=KL , R , PO=R . 
BELOAD, I=fylist. 

UNLOAD, TAPE. 

LIBRARY, BETONOS/D. 

where  fylist  contains: 

ID=abcd, PF=myfyll , FN=mynosbefyl 1 . 

ID=abcd, PF=myf yl2 , FN=mynosbefyl2 , CY=423 , TY=I . 
ID=efgh, PF=myfyl3,UN=abcd, FN=mynosbefyl3,CT=PU. 


BKSP 


Backspace  a  file  (by  logical  records). 

Syntax:  BKSP, lfn,n,m. 

Parameters:  lfn  -  the  file  to  be  backspaced 

n  -  decimal  number  of  logical 
backspace 

(Default:  1;  max:  262143) 

m  -  file  mode:  C  (coded)  or  B 
(Default:  B) 

Similar  commands:  COS:  SKIPF,  SKIPR 


records 


(binary) 


to 


Examples : 


BKSP ,myf i le , 4. 
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BLANK  Blank  label  a  magnetic  tape. 
Syntax: 


BLANK, VSN= vs n,MT \ NT , D=den | den, CV=cv,  FA=f a. 


Parameters : 


VSN= 


OFA=of a , VA=va , OWNER=us  e r name/ f ami lyname , 
LSL=lsl,U. 

-  1-  to  6-character  volume  serial  number 
(don't  use  a  current  local  file  name  or 
the  file  will  be  lost) 


MT 

NT 

D=den 

den 

-  7-track  tape 

-  9-track  tape 

-  tape  density 

MT 

NT 

den 

density 

den 

density 

LO 

200  cpi 

HD 

800  cpi 

HI 

556  cpi 

PE 

1600  cpi 

HY 

800  cpi 

GE 

6250  cpi 

200 

200  cpi 

800 

800  cpi 

556 

556  cpi 

1600 

1600  cpi 

800 

800  cpi 

6250 

6250  cpi 

CV= 

-  conversion  mode  for  9-track  labels 

(do  not 

use  with  MT) 

cv 

meaning 

AS 

ASCII/6“bit  display  code 

US 

same  as  AS 

EB 

EBCDIC/6“bit  display  code 

FA= 

-  File  accessibility  character 

fa 

meaning 

blank 

unlimited  access 

A 

only  the  owner  can  access  it 

other 

future  accesses  must  specify 
this  character 

OFA= 

-  old  file  accessibility  character  when 

relabelling  a  tape  with  one 

VA= 

-  volume 

accessibility  character 

va 

meaning 

blank 

unrestricted  access 

other  only  a  system  job  can  destroy 
the  V0L1  label 

(must  always  be  a  labelled  tape) 

0WNER=  -  ownership  identification  -  determines 
file  accessibility  (FA) 
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LSL=  -  label  standard  level  entered  in  VOLl 
label 

lsl  meaning 


1  tape  labels  and  data  format 

for  this  volume  are  ANSI  std 
blank  may  or  may  not  be  ANSI 
(Default:  1) 

U  -  unload  after  blank  labelling 

(Default:  do  not  unload) 

Similar  commands:  COS:  no  tapes 

VMS:  MOUNT 

Examples:  BLANK, VSN=NA9999 , D=GE. 


BLOCK  Add  one  or  more  lines  of  10x10  block  letters  to  a  file. 

Syntax:  BLOCK, lfn, rewind, cc./line_ 1/1 ine_2/ ... /I inen 

Parameters:  rewind  -  rewind  option 

R  -  rewind  lfn  before  writing 
NR  -  do  not  rewind  lfn 
(Default:  NR) 

cc  -  carriage  control  character  to  be 
inserted  before  the  first  line 
(Default:  1) 

/  -  a  delimiter  character  which  separates 

the  lines  in  the  command  -  may  be  any 
character  and  must  immediately  follow 
the  terminator  -  successive  delimiters 
generate  blank  lines 

line_i  -  a  string  of  up  to  10  characters  for  one 
line  of  blocked  characters  -  or  one  of 
the  following: 

DATE  -  current  date 
TIME  -  current  time 
USER  -  current  user  name 
UJN  -  user  job  name 
JSN  -  job  sequence  number 

Similar  commands:  VMS:  VSYS:BANNER,  VSYS:BANNER6 

Examples:  BLOCK, blockf. *myjob*date  < —  *  is  the  delimiter 
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BYE 


CATALOG 


(IAF)  Terminate  an  application. 

Syntax:  BYE, appl 

Parameters:  appl  -  if  IAF  is  your  primary  application,  appl 

is  one  of:  IAF,  RBF  (see  APPSW) 

if  IAF  is  your  secondary  application,  appl 
is  one  of: 

appl  meaning 


omitted  end  IAF  and  return  to  primary 
application 

ABORT  end  both  primary  and  secondary 

applications 

(anything  else  will  be  treated  the  same  as 
if  omitted) 

See  also:  GOODBYE,  LOGOUT;  HELLO,  LOGIN 

Similar  commands:  COS:  AZ,  QUIT 

NOS/VE,  VMS:  LOGOUT 

Examples:  BYE 


List  information  about  each  record  in  a  file. 


Syntax:  CATALOG, lfn,p_l,p_2, . . . ,p_n. 

Parameters:  lfn  -  the  file  to  be  cataloged. 


pi  -  parameters 

N=n  -  catalog  n  files 

N=0  -  catalog  until 

double  EOF 

N  -  catalog  until  E0I 

omitted  -  same  as  N=1 


L=name  -  the  output  file 

omitted  -  same  as  L=0UTPUT 


T 


U 


-  list  entire  text  for  records 
starting  with  APRD,  CMRD,  EQPD, 
IPRD,  LIBD 


-  list  all  records  in  a  user 
library 

omitted  -  list  ULIB  record 


D  -  suppress  comments  field  and  all 

but  first  page  heading 
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CATLIST 


CS  -  suppress  character  set  indicator 
(63/64)  for  OPL  and  OPLC  records 

R  -  rewind  lfn  before  and  after 

Remarks:  Don't  use  on  S,  L  or  F  tapes.  COPY  them  to  a 

disk  file,  or  to  an  I  or  SI  tape  before 
CATALOG ing . 

For  terminal  output,  set  to  NORMAL  mode. 

See  also:  ITEMIZE 

Similar  commands:  COS:  ITEMIZE 

Examples:  CATALOG, myfile,N,R. 


List  permanent  file  information. 


Syntax:  CATLIST, L0=lo, FN=pfn,UN=un,NA, L=1 fn, PW. 


Parameters:  LO=lo  -  list  options 

lo  meaning 


F  all  information  about  one  or  all 
files  (3  lines  per  file) 

FP  access  permissions  of  a  file 
0  .  (zero)  alphabetical  list  of  names 
of  indirect  and  direct  files 
P  list  only  names  of  users  who  have 
access  to  a  private  file  or  who 
have  accessed  a  semiprivate  file 
X  L0=F  plus  security  access 
categories  for  one  file 
(default:  0) 


FN=pfn  -  a  single  file  specification  (required  for 
L0=FP,  L0=P,  and  L0=X)  -  one  or  more 
single-character  wildcards  (*)  are 
allowed  (e.g.,  ABC****) 

L=lfn  -  file  to  receive  the  CATLIST  output 
(Default:  L=0UTPUT) 

PW  -  display  passwords  in  L0=F  output 


Remarks:  In  the  CATLIST  output,  a  filename  enclosed  in 

parentheses  means  the  file  is  on  the  MSS. 


Similar  commands:  COS:  AUDIT 

NOS/VE:  BACKUP_PERMANENT_FILES;  DISPLAY 
CATALOG;  DISPLAY_CATALOG_ENTRY 
VMS:  DIRECTORY 
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CDEFINE 


CDROP 


Examples:  CATLIST. 

CATLIST , LO=F , FN=myf i 1 e . 

CATLIST,  FN=ABC****.  <—  all  files  starting 

with  ABC 


Display  or  define  the  defaults  to  be  used  by  the  Cray  Station 
commands . 


Syntax:  CDEFINE. 


Parameters:  UN= 


-  user  name 

(default:  your  user  initials) 


PW=  -  your  860  password 

PN=  -  your  charge  number  (called  project  number 
in  the  display) 


DC=  -  output  disposition  code 
(default:  DC=BC) 


RUN=  -  RBF  output  user  name 

(default:  your  user  initials) 

QTF=  -  QTF  access 

(default:  OFF) 


Remarks:  Other  parameters  should  not  be  redefined  because 

they  are  not  used  at  DTRC  (CN=)  or  have  only  one 
value  at  DTRC  (MF=,  FN=,  RFN=) . 

You  must  use  CDEFINE  each  time  you  change  your 
Cray  password. 

Examples:  /CDEFINE. 

A —  displays  the  current  defaults 
CDEFINE>  help 

A —  displays  help  information 

(uppercase  if  in  ASCII  mode) 

CDEFINE>  exit 

A—  leave  CDEFINE 

(uppercase  if  in  ASCII  mode) 


(ICF)  Abort  an  executing  Cray  job  saving  the  output. 
Syntax:  CDROP, jsq. 

Parameters:  jsq  -  Cray  job  sequence  number 

See  also:  CSTATUS 

Similar  commands:  VMS  Cray  Station: 


Examples : 


CDROP, ABCD 
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CHANGE  Change  some  characteristics  of  a  permanent  file. 

Syntax:  CHANGE, nfn_l=ofn_l ,nfn_2=ofn_2, . . . ,nfn_n=ofn_n 

/PW=pw, CT=ct ,M=m, BR=br , PR=pr , SS=ss ,NA, CE, 
AC=ac , CP . 

Parameters:  nfn_i=ofn_i  -  change  old  file  name  to  new  file 

name 

PW=pw  -  new  password 

0  -  clear  the  password 

M=m  -  alternate  user  permission  mode  for 
semiprivate  and  public  files 

BR=br  -  backup  requirements 

br  meaning 


CR  off-station  backup 
Y  on-station  backup 

MD  backed  up  only  if  on  disk 

N  no  backup 

(MD  and  N  are  not  recommended) 

* 

PR-pr  -  preferred  residence 

pr  meaning 

M  alternate  storage  -  MSS 
N  no  preference 

SS=ss  -  new  interactive  subsystem 

(BASIC,  BATCH,  EXECUTE,  FORTRAN,  FTNTS , 
NULL) 

CE  -  clear  file  error  code 

AC=ac  -  may  alternate  users  obtain  information 
about  the  file?  (Y  or  N) 

CP  -  account  number  is  to  be  replaced  by 

the  account  number  currently  in  effect 

Similar  commands:  COS:  ALTACN;  MODIFY 

NOS/VE:  CHANGE_CATALOG_ENTRY;  CREATE_FILE_ 
PERMIT;  DELETE_FILE_PERMIT 
VMS:  SET  PROTECTION 

Examples:  CHANGE, mynew=myo Id. 

A —  rename  a  file 
CHANGE, myfile/CT=PU. 

A —  make  a  file  public 
CHANGE, myfil e/CP. 

A —  change  account  number  to  current 
value 
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CHARGE  Validate  charging  information  for  the  job. 

Syntax:  CHARGE, account_number . 

Parameters:  account_number  _  your  Job  Order  Number 

Remarks:  In  a  batch  job,  the  initial  CHARGE  statement  must 

immediately  follow  the  USER  statement  following 
the  job  statement. 

The  CHARGE  statement  may  also  be  used  to  change 
the  Job  Order  Number  for  subsequent  file  saves. 

Similar  commands:  COS:  ACCOUNT 

VMS:  your  home  directory  defines  the 
job  order  number 


Examples:  jobname. 

USER, ABCD, batch_password. 

CHARGE, 1222233344. 

A —  job  charged  to  1-2222-333-44 

CHARGE, 5666677788. 

DEFINE, NEWFILE. 

A —  file  charged  to  5-6666-777-88 


CHVAL,CN  Make  your  current  account  number  your  login  default, 


Syntax: 


CHVAL , CN . 
CHVAL , CN=0 . 


Parameters:  CN  -  means  "Charge  Number" 

(use  CN=0  to  turn  this  feature  off) 

Remarks:  After  executing  this  command,  you  will  no  longer 

need  to  supply  your  charge  number  when  you  login. 

This  is  especially  useful  if  you  have  only  one 
charge  number.  If  you  have  more  than  one,  you 
should  probably  avoid  this  since  the  charge 
number  used  at  login  is  used  for  charging  the 
entire  session. 


See  also: 


CHARGE 


Similar  commands:  NOS/VE:  SET_DEFAULT_LOGIN_PROJECT  (DTRC) 

Examples:  CHVAL, CN. 

CHARGE, 1222233344. 

A —  change  current  charge  number  to 
another  (must  be  one  of  your 
registered  numbers)  for  making 
permanent  files 

< —  this  is  now  your  login  default 


CHVAL, CN. 
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CJOB  (ICF)  Get  the  status  of  a  specific  Cray  job. 

Syntax:  CJOB , jname , j  sq, L=lfn, RT=rt . 

Parameters:  jname  -  job  name  from  JOB  statement  (uppercase) 

jsq  -  optional  job  sequence  number  (CSTATUS) 

L=  -  local  file  to  receive  the  status 
(default:  OUTPUT) 

RT=  -  repeat  time  (seconds) 

(default:  do  not  repeat  the  command) 

See  also:  CSTATUS 

Similar  commands:  VMS  Cray  Station:  STATUS 
Examples:  CJOB,MYJOB. 

CKILL  (ICF)  Delete  an  input  job,  kill  an  executing  job  saving  only 
the  logfile,  delete  an  output  dataset 

Syntax:  CKILL, jsq. 

Parameters:  jsq  -  job  sequence  number 

See  also:  CSTATUS 

Similar  commands:  VMS  Cray  Station.  BTCT 
Examples:  CKILL, abed. 


CKP  Take  a  checkpoint  dump. 

Syntax:  CKP, lfn_l , lfn_2, . . . , lfn_n. 

Parameters:  lfn_i  -  a  file  to  be  included  in  the  checkpoint 

dump 

(Default:  all  local  files) 

Examples:  CKP. 


CLEAR  Release  all  (or  all  but  one  or  more  specified)  files  assigned 
to  the  job. 

Syntax:  CLEAR.  < —  all  files 

CLEAR lfnl , lfn2, ..., lfnn.  < —  all  except  those 

named 
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Remarks:  Checkpoint  and  no-auto-drop  files  are  not 

released. 

See  also:  RETURN,  SETFS 

Examples:  CLEAR. 

CLEAR , * , keepfyl . 


COBOL5  Compile  COBOL  74  program. 

Syntax :  COBOL5 ,B=b,I=i,L=l, LO= lo,PD=pd,SY. 

Parameters:  B=PUNCHB  Produce  punched  binary  decks  of  all 

routines 

B=lfn  Put  binary  into  a  file 

B  Same  as  B=BIN 

B=0  No  binary  output 

omitted  Same  as  B=LG0 

FORTRAN  source  input  is  in  lfn 
Same  as  I=COMPILE 
Same  as  I=INPUT 

Output  lists  to  file  lfn 
Listings  are  suppressed 
Same  as  L=LIST 
Same  as  L=OUTPUT 

LO=op/op/...  Listing  options  (see  L  parameter) 
op  meaning 

M  address  map 

0  object  code  listing 

(use  only  if  requested  by  Code 
3511) 

R  cross-reference  map 

S  source  code  list 

LO  Same  as  L0=M/S/R 

L0=0  No  M,  0,  R,  S  information 

omitted  Same  as  L0=S 

PD=8  Print  density  (listings  at  8  lines 

per  inch,  single  spacing) 

PD=6  listings  at  6  lpi  single  spacing 

PD=4  listings  at  8  lpi  double  spacing 

PD=3  listings  at  6  lpi  double  spacing 

PD  Same  as  PD=8 

omitted  Same  as  PD=6 

Syntax  check  only;  do  not  produce 
object  code 

(cuts  compilation  time  roughly  in  half) 
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COMMENT 


COPY 


Similar  commands:  NOS/VE,  VMS:  COBOL 

Examples:  COBOL5.  Defaults  to:  1=INPUT, L=OUTPUT, LO=S, 

B=LGO 

COBOL5,I=INP, L=OUTP , LO, SY , PD=8. 


Place  a  comment  in  the  system  dayfile  and  your  job's  dayfile. 


Syntax:  COMMENT, j sn . comment 

COMMENT. comment 
’'comment 


Parameters:  jsn  -  jsn  of  job  to  receive  the  comment 

Default:  the  current  job 

comment  -  the  message  to  be  put  into  the  dayfile 

See  also:  NOTE  (for  on-line  messages  from  a  procedure) 

Similar  commands:  COS:  * 

NOS/VE:  DISPLAY_MESSAGE 
VMS :  ! 

Examples:  COMMENT. MARK  1  < —  these  are 

"MARK  1  < —  the  same 


Copy  data  from  one  file  to  another. 


Syntax:  COPY ,I=lfni,0=lfno,V=x,M=c,TC=tc,N=copycnt, 

BS=bs ize , CC=charcnt ,EL=erlimit, 

PO=plp2 . . . pn , L=lf nl , NS=ns . 


COPY, lfni,lfno,x,c,tc, copycnt ,bsize,charcnt, 
erlimit,plp2. . .pn, lfnl, ns. 

Parameters:  1=  -  file  to  be  copied 

(default:  INPUT) 


0=  -  output  file 

(default:  OUTPUT) 

V=  -  non-null  to  rewind,  copy,  rewind,  verify, 
rewind  both  files  (x  must  not  be  0) 
(default:  no  verify) 

M=  -  coded  files 

c  meaning 

Cl  only  input  is  coded 

C2  only  output  is  coded 

x  both  input  and  output  are  coded 
(x  is  non-null,  except  Cl,  C2) 
(default:  binary) 
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TC=  ~  termination  condition  with  N= 
tc  meaning 


F  or  EOF  N  is  number  of  files 

I  or  EOI  N  is  ignored 

(copy  to  end~of~inf ormation) 

D  or  EOD  N  is  number  of  double  EOFs  to 
copy  to 

(N>1,TC=D, VERIFY  verifies  only 
to  the  first  empty  file) 
(default:  TC=D) 

N=  -  copy  count  (meaning  determined  by  TC=) 
(default:  N=l) 

BS=  -  maximum  block  size  (in  CM  words)  of  S  or  L 
tape  PRU  (cannot  be  used  with  CC=) 

(defaults:  S  tape:  1000  octal; 

L  tape:  2000  octal) 

CC=  -  maximum  number  of  characters  in  S  or  L  tape 
block 

(default:  not  used;  size  from  BS=) 

EL=  -  number  of  non-fatal  errors  before  abort; 
EL=U  for  unlimited  error  processing 
(default:  0) 

P0=  -  processing  options: 

pi  meaning 

E  copy  input  blocks  with  parity  or 
block-too-long  errors 
(default:  error  blocks  skipped) 

D  delete  noise  blocks  in  copy  from 

disk,  I-  or  Si-tape  to  S~  or  L~tape 
(defaults:  binary  padded  with  00B  to 
noise  block  size; 
coded  padded  with  blanks) 

R  allow  record  splitting  in  copy  from 
disk,  I-  or  SI~tape  to  S-  or  L~tape 
(default:  splitting  not  allowed) 

M  copy  according  to  TC;  do  not  write 
EOFs 

(default:  write  EOF  after  each  file) 

L=  ~  alternate  file  for  parity  error  messages 
for  EL<>0;  cannot  be  same  as  I=,  0= 
(default:  OUTPUT) 

NS=  -  noise  size  for  S,  L  or  F  input  tapes 

(maximum:  41;  NS=0  uses  default  of  18) 


Page  1-24 


RevO 


90/09/30 


See  also:  TCOPY,  SCOPY 

Similar  commands:  COS:  COPYD;  COPYF;  COPYR;  COPYU 

NOS/VE:  C0PY_FILE;  F I LE_MANAGEMENT_UT I L I T Y 
VMS:  COPY 

Examples:  COPY, a, b. 

COPY, a, b, verify. 


COPY , a , b , TC=F, N=nf i les . 

A —  copy  S  or  L  tape 


COPYBF  Copy  a  multi-file  file  in  binary  mode. 

COPYBR  Copy  records  from  one  file  to  another  in  binary  mode. 

Syntax:  COPYBF, lfn_in, 1 fn_out ,nf i les , c . 

COPYBR , lfn_in, 1 f n_out , nr ecs , c . 

Parameters:  nfiles  -  decimal  number  of  files  to  copy 

nrecs  -  decimal  number  of  records  to  copy 

c  -  non-null  indicates  coded  S  or  L  tape 

Defaults:  COPYBF, INPUT, OUTPUT, 1 . 

COPYBR, INPUT, OUTPUT, 1. 


Remarks:  Not  recommended  for  S  or  L  tapes. 

Copies  from  current  position. 

If  lfn_in=lfn_out ,  the  file  is  read. 

See  also:  COPYCF,  COPYCR,  COPYEI 

Similar  commands:  COS:  COPYD;  COPYF;  COPYU 

Examples:  COPYBF, fyl 1 , f yl 2, 4. 

COPYBR, fyll,fyl2, 125. 


COPYBFR  (DTRC)  Restore  the  "randomness"  of  a  random  file  which  was 
copied  using  a  sequential  copy  such  as  COPYBF. 

Syntax:  BEGIN, COPYBFR, , f ilel , f ile2. 

Parameters:  filel  -  input  file 


file2  -  output  file 
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Remarks:  This  most  often  happened  when  a  NOS/BE  UPDATE 

random  PL  was  copied  to  tape  using  COPYBF  instead 
of  either  COPYBR  or  UPDATE, B.  When  the  file  is 
copied  back  to  disk  under  NOS,  there  is  an  EOF  at 
the  end  of  the  file,  making  it  unusable  as  an 
UPDATE  PL.  COPYBFR  will  undo  this. 


Examples :  COPYBFR, nosbefyl , nosfyl . 


COPYCF  Copy  a  coded  multi-file  file. 

COPYCR  Copy  records  from  one  coded  file  to  another. 


Syntax:  COPYCF, lfn_in, lfn_out ,nf iles , 

fchar , lchar ,na. 

COPYCR, lfn_in, lfn_out,nrecs, 
fchar, lchar, na. 

Parameters:  nfiles  -  decimal  number  of  files  to  copy 

nrecs  -  decimal  number  of  records  to  copy 

fchar  -  first  character  position  of  line  to  copy 

lchar  -  last  character  position  of  line  to  copy 

na  -  non-null  to  not  abort  if  no  line 
terminator  before  EOR 

When  used  with  6/12-bit  files,  FCHAR  and  LCHAR 
may  give  unexpected  results.  For  6/12-bit  files, 
LCHAR  should  be  at  least  twice  the  number  of 
characters  in  the  longest  line. 

Defaults:  COPYCF, INPUT, OUTPUT, 1 , 1 , 136 . 

COPYCR , INPUT , OUTPUT ,1,1,136. 


Remarks:  Not  recommended  for  S  or  L  tapes. 

Copies  from  current  position. 

If  1 fn_in=l fn_out ,  the  file  is  read. 

A  coded  file  contains  lines  of  500  or  fewer 
characters,  terminated  with  a  zero-byte  (12-bits). 

Lines  longer  than  500  6~bit  characters  are 
truncated. 


For  coded  SI  tapes,  use  TCOPY. 
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See  also:  COPY,  COPYBF,  COPYBR,  COPYEI,  SCOPY,  TCOPY 

Similar  commands:  COS:  COPYD;  COPYF;  COPYU 

Examples:  COPYCF, cfyl 1 , cfyl2 . 

COPYCR, cfyl l,cfyl2,2,7,35,x. 


COPYEI  Copy  one  file  to  another. 

Syntax :  COPYEI , lfn_in, 1 fn__out , x , c. 

Parameters:  lfn_in  -  file  to  be  copied 

lfn_out  -  the  copy  of  the  input  file 

x  -  non-null  to  rewind,  copy,  rewind, 

verify,  rewind  both  files 

c  -  non-null  indicates  coded  S  or  L  tapes 

(default:  binary) 


Defaults:  COPYEI , INPUT, OUTPUT. 

Remarks:  Not  recommended  for  S  or  L  tapes. 

Copies  from  current  position. 

If  lfn_in=lfn_out ,  the  file  is  read  to 
end-of-inf ormat ion. 


See  also:  COPY,  COPYBF,  COPYCF 

Similar  commands:  COS:  COPYD 

NOS/VE:  C0PY_FILE 
VMS:  COPY 

Examples:  COPYEI ,myin,myout . 


COPYL  Selective  single  replacement  of  object  modules. 

Syntax:  COPYL, oldfyl , repfyl ,newfyl , last , f lag. 

Parameters:  oldfyl  -  old  master  binary  file  of  object  modules 

(Default:  OLD) 

repfyl  -  replacement  file  of  object  modules 
(Default:  LGO) 

newfyl  -  new  master  binary  file  of  object  modules 
(Default:  NEW) 
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last  -  name  of  last  record  in  oldfyl  to  be 
processed 

(Default:  all  records  processed  from 

current  position  to  EOF  or  EOI) 

flag  -  processing  options 

R  -  rewind  oldfyl  and  newfyl  before 
processing 

(repfyl  is  always  rewound) 

A  -  append  to  newfyl  all  records  in 
repfyl  which  do  not  match  any  of 
oldfyl 

(Default:  non-matching  records 
ignored) 

T  -  match  record  name  but  not  type 
(Default:  must  match  record  name 
and  type) 

E  -  process  oldfyl  through  EOI 
(may  be  selected  in  any  combination: 

RA,  ART,  TEAR,  etc. ,  up  to  four 
characters;  extra  characters  ignored) 
(default:  option  not  selected) 

Defaults:  COPYL.OLD, LGO,NEW. 

Remarks:  Oldfyl  is  processed  forward  only,  but  binary  will 

be  searched  as  often  as  needed. 

See  also:  COPYLM 

Similar  commands:  COS:  BUILD 

NOS/VE:  F I LE_MANAGEMENT_UT I L I T Y 
VMS:  LIBRARIAN 

Examples :  COPYL, oldlgo , lgo ,newlgo . 


COPYLM  Selective  multiple  replacement  of  object  modules. 
Syntax:  COPYLM, oldfyl .binary, newfyl. 

COPYLM, oldfyl , binary, newfyl , last , flag. 


Parameters:  see  COPYL;  flags  T,  E  do  not  apply  to  COPYLM 

Defaults:  COPYLM, OLD, LGO, NEW. 


Remarks : 


See  also: 


All  occurrences  of  a  module  in  oldfyl  will  be 
replaced  by  the  first  occurrence  of  a  module  with 
the  same  name  in  binary. 

COPYL 


Similar  commands:  COS:  BUILD 

NOS/VE:  FILE_MANAGEMENT_UTILITY 
VMS:  LIBRARIAN 


Examples : 


COPYLM, oldlgo, lgo,newlgo,R. 
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COPYSBF 


Copy  a  file,  shifting  the  lines  one  character  to  the  right  for 
printing  on  a  printer. 

Syntax:  COPYSBF, lfn_in, lfn_out ,nf i les , na . 

Parameters:  lfn_in  -  file  to  be  copied 

lfn_out  _  the  copy  of  the  input  file 

nfiles  -  decimal  number  of  files  to  copy 

na  -  non-null  to  not  abort  if  no  line 

terminator  before  EOR 


Defaults:  COPYSBF, INPUT , OUTPUT, 1 . 

Remarks:  Not  recommended  for  S  or  L  tapes. 

Copies  from  current  position. 

If  lfn_in=lfn_out,  the  file  is  read. 

A  coded  file  contains  lines  of  500  or  fewer 
characters,  terminated  with  a  zero-byte  (12-bits). 

Lines  longer  than  500  6-bit  characters  are 
truncated. 

A  page  eject  is  inserted  at  the  start  of  each 
logical  record. 

See  also:  COPYSF8 

Similar  commands:  COS:  COPYD 

VMS:  VSYS:CPYSF  (DTRC) 


Examples : 


COPYSBF,myprog. 
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C0PYSF8  (DTRC)  Copy  an  ASCII8  file,  shifting  the  lines  one  character 
to  the  right  for  printing  on  a  printer. 

Syntax :  COP YSF8 , FROM, TO , NFILES , REWIND. 

Parameters:  FROM  -  ASCII8  file  to  be  copied 

TO  -  the  copy  of  the  input  file 

NFILES  -  decimal  number  of  files  to  copy 
(default:  1) 

REWIND  -  rewind  option 
rew  meaning 

R  rewind  input  and  output  before 
and  after  the  copy 
(synonyms:  REWIND,  Y,  YES) 

N  copy  from  the  current  position 

and  leave  the  files  ar  EOI  after 
the  copy 
(synonym:  NO) 

(default:  N) 

Remarks:  COPYSF8  uses  FCOPY  to  convert  from  ASCII8  to  ASCII; 

COPYSBF  to  shift;  FCOPY  to  convert  back  to  ASCII8. 

See  also:  COPYSBF 

Examples :  COPYSF8 ,myf i le , shf tfyl , ,R. 

COPYX  Copy  a  file  until  a  user-specified  condition  is  met. 

Syntax:  COPYX, lfn_in, 1 fn_out , x , b , c . 

Parameters:  lfn_in  -  file  to  be  copied 

lfn_out  -  the  copy  of  the  input  file 

x  -  copy  specifications 

x  meaning 


n  decimal  number  of  records 

00  copy  through  first  zero- 

length  record 

name  copy  through  this  record 

type/name  copy  through  this  record 
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b  -  backspace  control 

x  meaning 


0  no  backspace 

]  backspace  input  file  one  record 
after  copy 

2  backspace  output  file  one  record 
after  copy 

3  backspace  both  files  one  record 
after  copy 

(ignored  if  EOF  or  EOI  before  x  met) 

c  -  non-null  indicates  coded  S  or  L  tape 

(default:  binary) 

Defaults:  COPYSBF, INPUT, OUTPUT, 1 . 

Remarks:  Not  recommended  for  S  or  L  tapes. 

Copies  from  current  position. 

If  lfn_in=lfn_out ,  the  file  is  read. 

A  coded  file  contains  lines  of  500  or  fewer 
characters,  terminated  with  a  zero-byte  (12-bits). 

Lines  longer  than  500  6~bit  characters  are 
truncated. 

A  page  eject  is  inserted  at  the  start  of  each 
logical  record. 

See  also:  COPYBR,  COPYCF,  COPYCR 

Similar  commands:  COS:  COPYF;  C0PYR;  COPYU 
Examples:  COPYX, fyll , fyl2, 125. 

CRERUN  (ICF)  Immediately  end  processing  of  specified  job, 

delete  output,  and  resubmit  to  input  queue,  if  allowed. 

Syntax:  CRERUN, jsq. 

Parameters:  jsq  -  job  sequence  number 

Remarks:  A  job  cannot  be  rerun  if: 

.  a  dataset  has  been  adjusted,  modified, 
saved,  deleted,  or  written  on 
.  RERUN, DISABLE  has  been  executed 

See  also:  RERUN 


Examples : 


CRERUN, 9876. 
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CSET  (IAF)  Change  the  terminal's  character  set  mode. 

Syntax:  CSEI,mode 

Parameters:  mode  -  one  of: 

ASCII  "  ASCII  128-character  set 
NORMAL  -  ASCII  graphic  64-character  set 

Remarks:  CSET  may  appear  in  a  procedure. 

See  also:  CSET, NORMAL  does  not  affect  AUTO  or  BRIEF  mode. 

Examples:  CSET, ASCII 


CSTATUS  (ICF)  Get  the  status  of  jobs,  and  input  and  output  datasets. 

Syntax:  CSTATUS , queues , ST=s tart , L=lfn ,RT=rt . 

Parameters:  queues  -  one  or  more  of: 

value  meaning 


E  or  EXECUTION  execution  queue 

I  or  INPUT  input  queue 

0  or  OUTPUT  output  queue 

R  or  RECEIVING  Cray  mainframe 

receiving  queue 

S  or  SENDING  Cray  mainframe 
sending  queue 

A  or  ALL  all  of  the  above 

(Default:  ALL) 

ST=  -  decimal  number  of  entries  to  skip  befor 
starting  the  display 
(default:  0) 

L=  -  local  file  to  receive  the  status 
(default:  OUTPUT) 

RT=  -  repeat  time  (seconds) 

(default:  do  not  repeat  the  command) 

Remarks:  If  RT  is  specified,  %2  may  be  needed  to  cancel 

the  output. 


Examples : 


CSTATUS. 
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CSUBMIT 


CTASK 


(ICF)  Submit  a  job  to  a  Cray  mainframe. 


*>yn  t  aX  • 


r'riTruTT  1  r  _  r>  r> 
W  ^  i  X  X  f  X  X  ii  f 


5 cr, NO, TO. 


Parameters:  lfn  -  local  file  containing  the  Cray  job 

(display  code  or  8/12-bit  ASCII) 

RB=  -  (remote  batch  submission)  user  to  receive 
the  output 

RB  -  put  the  output  into  the  print  queue  for  you 
(default:  print  at  Central  Site) 


NO  -  drop  output  at  job  termination 
TO  -  put  the  output  in  the  wait  queue 


Remarks:  Other  parameters  are  available  for  running 

another  u,ar's  job. 

The  control  statement  record  ($CS)  determines  the 
transfer  mode  for  FETCH,  DISPOSE,  MSFETCH, 


MSSTORE,  etc.,  in  the  job.  For  example,  if  $CS 
is  8/12  ASCII,  all  coded  files  transferred 
must/will  be  8/12  ASCII. 


Similar  commands:  VMS:  CRAY  SUBMIT 

VMS  Cray  Station:  SUBMIT 

Examples:  CSUBMIT, mycray. 

A —  output  to  860  printer 

CSUBMIT, mycray, RB=un. 

A —  output  to  un's  output  queue 
(see  QGET) 

CSUBMIT, mycray, RB. 

A —  output  to  your  output  queue 
(see  QGET) 


Transfers  the  file  between  the  Cray  and  the  CDC  NOS  front-end. 

Syntax:  CTASK, ALL, code . 

Parameters:  ALL  -  include  the  dayfile  from  the  CDC  NOS  job 

with  the  Cray  logfile 

(default:  the  dayfile  is  not  included) 

code  -  internal  code  of  the  CDC  NOS  file 
ASCI 18  -  8/12-bit  ASCII 
DIS  -  display  code 
(default:  display  code,  unless  the  whole 
job  is  ASCI 18) 
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CTIME 


DATE 


DAYFILE 


Remarks:  The  text  field  of  a  Cray  ACQUIRE,  DISPOSE  or 

FETCH  statement  can  include  NOS  commands  to  fetch 
or  store  the  file.  CTaSK  causes  the  file 
transfer  to  occur. 

Examples:  See  pages  2~1~8,  3— 1— 3 . 


Put  the  accumulated  CFU  time  (in  seconds)  into  the  job's 
dayf ile. 

Syntax:  CTIME. 

See  also:  RTIME ,  STIME 

Similar  commands:  VMS:  AT 
Examples:  CTIME. 


(DTRC)  Put  the  da^e  and  time  into  the  dayfile. 


Syntax: 
Remarks : 


Examples : 


BEGIN, DATE. 

A  typical  dayfile  message  is: 
TODAY  IS  90/09/11  AT  1425 

BEGIN, DATE. 


Write  the  job's  dayfile  (or  a  subset)  to  a  file. 

Syntax:  DAYFILE, L=lfn, FR=string,OP=op,PD=pd,PL=pl , 

I=inf ile. 

DAYFILE, 1 fn, string, op, pd, pi, inf ile. 

Parameters:  L=  -  the  file  to  which  the  dayfile  is  to  be 

written  (on  a  new  page  if  OUTPUT  or  if  PD 
or  PL  specified) 

(Default:  L=0UTPUT) 

FR=  -  search  string  in  field  OP  for  starting  the 
copy.  $~delimited  if  any  non-alphanumerics 
in  the  string  (time  starts  with  a  blank; 
interactive  commands  start  with  a  for 

example:  $$$0LD$) .  If  found,  the  dayfile 
is  copied  from  this  point.  If  not  found, 
a  message  (connected  or  disconnected  L)  and 
the  entire  dayfile  (connected  L)  are 
written. 
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DEFINE 


Remarks : 


0P=  -  search  option 

op  meaning 

T  search  time  field 

M  search  message  field 

I  incremental  dump  (from  point  of  last 

DAYFILE  command) 

F  full  dump 

(Defaults:  0P=M  (FR,  but  no  OP); 

0P=F  (L  disconnected) ; 

0P=I  (L  connected) 


PD=  -  print  density 

pd  meaning 


3  double  space,'  6  Ipi 

4  double  space;  8  lpi 
6  single  space;  6  lpi 
8  single  space;  8  lpi 


PL=  -  page  size 

pd  page  size 


3 

4 
6 
8 


defaults 


pi  /  2 
pi  /  2 

Pi 

Pi 


30  lines 
30  lines 
60  lines 
60  lines 


file  containing  a  dayfile  for  input 
(Default:  the  active  dayfile) 


A  paginated  dayfile  cannot  be  used. 


Similar  commands:  COS:  ECHO 

NOS/VE:  DISPLAY_LOG 
VMS:  /LOG  qualifier 


Examples:  DAYFILE, ,$  11.21. S,T. 

A —  start  with  the  last  occurrence  of 
11.21.  in  the  time  field 


DAYFILE, I=DAY,FR=$$$GET, STATS. $. 

A —  start  with  the  last  occurrence  of 
$GET, STATS,  in  the  message  field 
of  the  dayfile  in  file  DAY 


Create  an  empty  direct  permanent  file. 

DEFINE, 1 fn_l=pfn_l , lfn_2=pfn_2, . . . , 1 f n_n=pf n_n 
/PW=pw,CT=ct ,M=m, BR=br , PR=pr , S= space ,NA, 
AC=ac . 


Syntax: 
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Parameters:  See  CHANGE. 


PW=pw  -  a  1-  to  7-character  password  required 
by  others  for  access 

BR=br  -  backup  requirements 

br  meaning 


CR  off-station  backup 

Y  on-station  backup 

MD  backed  up  only  if  on  disk 

N  no  backup 

(HD  and  N  are  not  recommended) 
(Default:  Y) 


CT=ct  -  (Default:  CT=PRIVATE) 

PR=pr  -  preferred  file  residence 

pr  meaning 


D  disk 

L  locked  to  disk 

M  alternate  storage  (MSS) 

N  no  preference 

T  tape  alternate  storage 
(Default:  PR=N) 

S=space  -  number  of  PRUs  requested  for  the  file 
(default:  the  minimum  number  of  blocks 
(a  multiple  of  704  PRUs) 

needed  to  hold  the  file) 

See  also:  REPLACE;  SAVE 

Similar  commands:  COS:  SAVE 

NOS/VE:  CREATE_FILE 
VMS:  CREATE 

Examples:  DEFINE, myf i le/CT=PU. 


(IAF)  Send  a  one-line  message  to  another  user. 


Syntax : 


DIAL, j  sn, sss 


Parameters:  jsn  -  job  sequence  number  of  the  receiving 

terminal 


Remarks : 


sss  -  the  one-line  message 

You  must  be  in  the  ACCESS  subsystem. 


No  queueing  takes  place  if  jsn  is  busy. 


See  also: 


WHAT JSN 
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DISPLAY 


DMB 


Similar  commands:  VMS:  PHONE 

Examples:  ACCESS 

WHATJSN 

DIAL, jsn, message 

BATCH  < —  reset  yourself 


Evaluate  an  expression  and  put  the  result  into  the  job's 
dayfile  in  octal  and  decimal. 

Syntax:  DISPLAY ,expl,exp2, . .. ,expn. 

Parameters:  expi  -  any  valid  symbolic  name  or  expression 

(value  may  be  up  to  10  digits) 

See  also:  SET 

Similar  commands:  COS:  PRINT 

NOS/VE:  CREATE_FILE_CONNECTION; 

DISPLAY_VALUE 
VMS:  WRITE  SYSSOUTPUT 


Examples : 


DISPLAY, TIME. 

1253  2345B 


SET,Rl=99. 
DISPLAY, Rl. 

99  143B 


DISPLAY, 1A3B. 

99  143B 


DISPLAY, 3/2. 
1  IB 


< —  if  time  is  12:53 

< —  register  Rl 

< —  octal  number  with  B 

< —  integer  division 


Binary  dump  of  exchange  package. 

Syntax:  DMB, ordinal. 

Parameters:  ordinal  -  an  octal  number  (0-777777)  used  to 

create  the  dump  record  number  (D  plus 
ordinal)  -  ordinal  >  377777  aborts  the 
job  after  the  dump 
(Default:  0  ==>  D000000) 

Remarks:  The  dump  is  written  to  file  ZZZZDMB  (an 

unconnected  local  file),  which  is  never  rewound. 


See  also:  DMD,  DMP 


Similar  commands:  COS:  DUMPJOB/DUMP 


Examples : 


DMB. 
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DMD 


DMP 


DROP 


Dump  the  exchange  package  or  central  memory  in  both  octal  and 
display  code. 


Syntax:  DMD.fwa.lwa. 

DMD , 1 wa . 

DMD. 


(1) 

(2) 

(3) 


Parameters : 


fwa  -  first  word  address  of  memory  to  be  dumped 
(relative  to  RA) 


lwa  -  last  word  address  to  be  dumped 
(relative  to  RA) 

Format  1:  dump  a  specified  range  of  memory 
Format  2:  dump  from  RA+0  thru  specified  lwa 
Format  3:  dump  the  exchange  package  and  40B 

locations  before  and  after  the  program 
address 


Remarks:  The  dump  is  written  four  words  per  line  to  file 

OUTPUT.  Interactively,  it  is  generally  written 
to  file  ZZZDUMP,  which  is  never  rewound. 

See  also:  DMP 


Similar  commands:  COS:  DUMP JOB/DUMP 

VMS: 


Examples:  DMD, 50  ^00, 60000. 


Dump  the  exchange  package  or  central  memory  in  octal. 

Syntax:  Same  as  DMD. 

Similar  commands:  COS:  DUMP JOB/DUMP 

VMS: 

Examples:  DMP, 47000. 


Drop  any  of  your  executing  or  queued  files  (except  the  job 
issuing  the  DROP  command) . 


Syntax :  DROP , JSN=j  sn,DC=q ,UJN=ujn, 0P=R. 

DROP , j  sn , q , u j  n , R . 

Parameters:  JSN=  -  either  or  both 

UJN=  -  may  be  specified 
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DC=  -  disposition  code 


dc 

meaning 

WT 

waiting  jobs 

PR 

print  jobs 

PU 

punch  jobs 

PL 

plot  jobs 

IN 

input  jobs 

EX 

executing  jobs 

ALL 

all  your  jobs 

(Defaults:  none  (JSN=,UJN=  omitted); 

ALL  (JSN=  or  UJN=  specified)) 

OP=  -  drop  executing  jobs  without  EXIT,  but  with 
single-reprieve  processing 

Similar  commands:  NOS/VE:  TERMINATE_INPUT;  TERMINATE_ JOB ; 

TERMINATE_OUTPUT;  TERMINATE_PRINT 
VMS:  STOP 

Examples:  DROP,ABCD.  < —  drop  executing  job  ABCD 

DROP, JSN=ABCD,OP=R. 

A —  drop  executing  job  with 

single-reprieve  but  no  EXIT 
DROP,, PR.  < —  drop  all  print  jobs 

DROP.  <--  invalid  (JSN,  UJN  or  DC 

required) 


ELSE  Terminate  skipping  (false  IF  command  with  same  label) ,  or 

initiate  skipping  (true  IF  command  with  same  label)  to  ENDIF 
with  same  label. 

Syntax:  ELSE, label. 

Parameters:  label  -  alphanumeric  string  (axxxxxxxxx,  1-10 

characters) 

See  also:  IF 

Similar  commands:  COS,  NOS/VE,  VMS:  ELSE;  ELSEIF 
Examples:  SET,Rl=l. 


IF,R1=1,D0IT. 

statements  to  do  if  true> 
ELSE, DOIT. 

Statements  to  do  if  false> 
ENDIF, DOIT. 
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END  IF 


ENDW 


ENQUIRE 


Terminate  skipping  by  a  SKIP,  IF,  or  ELSE  command  with  a 
matching  label. 

Syntax:  ENDIF, label. 

Parameters:  label  -  alphanumeric  string  (1-10  characters, 

starting  with  a  letter) 

See  also:  ELSE,  IF 

Similar  commands:  COS,  VMS:  ENDIF 

NOS/VE:  IFEND 


Examples:  See  IF. 


The  end  of  a  WHILE  loop. 

Syntax:  ENDW, label. 

Parameters:  label  -  alphanumeric  string  (1-10  characters, 

starting  with  a  letter) 

See  also:  WHILE 

Similar  commands:  COS:  ENDLOOP 

NOS/VE:  WHILEND 

Examples:  WHILE, Rl<5 , DOIT. 

•  •  • 

SET,R1=R1+1. 

ENDW, DOIT. 


Get  information  about  your  jobs. 


Syntax:  ENQUIRE, 0P=plp2. . .pn,FN=lfnl ,0=lfn2. 

ENQUIRE , plp2 . . .pn. 

ENQUIRE, JSN=jsn, 0=1 fn2. 

ENQUIRE, UJN=ujn, 0=1 fn2. 

ENQUIRE. 


Parameters:  0P=  -  Up  to  7  of  the  following  options: 

pi  meaning 


A  same  as  BDRUJLF 
B  identification  and  priority  info 

D  resources  demanded  and  assigned 

F  status  of  files  assigned  to  your  job 
J  contents  of  control  registers,  error 
flags  fields,  succeeding  commands 
L  loader  info  including  status  of  CID 
R  amount  of  resources  used  (CPU  time, 
mass  storage,  perm  file,  and  adder 
activity,  SRUs  used) 
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S  accumulated  SRUs 

T  accumulated  cpu  time 

U  initial  amount  of  resources 

available  (seconds,  job  step  RSU, 
account  block  SRU,  remaining 
resources  available  for  dayfile 
messages,  commands,  and  mass 
storage) 

(Default:  0P=A) 

JSN=  -  returns  detailed  report  on  this  job 
UJN=  -  returns  one-line  report  for  each  of  your 
j  obs 

FN=  -  returns  the  status  of  local  file  lfnl 
0=  -  writes  the  output  to  file  lfn2 

(Default:  interactive:  a  2-line  report  on  the 
current  job) 

Similar  commands:  VMS:  SHOW  SYSTEM 

NOS/VE:  DISPLAY_JOB_STATUS; 

DISPLAY_OUTPUT_STATUS 

Examples:  /ENQUIRE, B  < —  display  system  activity 

/ENQUIRE, JSN  < —  display  all  of  your  jsn's 

/ENQUIRE , JSN=abcd , 0=out 

A —  display  status  and  remaining 
commands  for  job  ABCD;  write 
display  into  file  OUT 

/ENQUIRE  < —  a  2-line  report  on  the 

current  job 

/ENQUIRE, UJN  < —  display  status  of  your  jobs 


ENTER  Enter  a  series  of  commands  on  one  line. 


Syntax :  ENTER . / commandl/command2/ . .  .  / commandn 

Parameters:  /  -  delimiter  -  any  character  not  in  any 

commandi  -  immediately  follows  the 
terminator 


commandi  -  any  NOS  command  (except  interactive 
commands  with  no  batch  counterpart) 

Remarks:  The  system  supplies  a  terminator  if  it  is  missing 

from  any  commandi. 

Examples:  BATCH  < —  enter  the  batch  subsystem 

$RFL,0.  < —  displayed  on  entry  to  batch 

/ENTER. \get, fprog\ftn5, i=fprog\map , part\lgo\ 

\exi t\dmp\rewind,zzzdump\copy , zzzdump 
A —  (must  fit  on  one  line) 

compile  and  execute  a  program 
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ERRMSG  Control  the  display  of  error  messages  in  a  procedure. 
Syntax:  ERRMSG, status . 

Parameters:  status  -  OFF  -  turn  off  display  of  messages 

ON  -  turn  on  display  of  messages 
(Default:  ON) 

Remarks:  ERRMSG  has  no  effect  in  a  batch  job. 

Examples:  ERRMSG, OFF. 


EVICT  Release  file  space  but  not  the  file  assignment. 

Syntax:  EVICT, lfnl , lfn2, ... . 

Remarks:  If  the  file  is  a  magnetic  tape  or  a  read-only 

disk  file,  the  file  assignment  is  also  released. 

Similar  commands:  VMS:  create  a  new  version  (disk) 

Examples:  EVICT, myfyl. 


EXECUTE  (IAF)  Select  the  execute  subsystem. 

Remarks:  Not  recommended  at  DTRC. 


EXECUTE  (Loader)  Complete  loading,  ±  '.erate  load  map  (if  requested), 
begin  execution;  or  execute  at  a  specific  entry  point. 


Syntax:  EXECUTE. 


Parameters : 


See  also: 
Examples : 


EXECUTE , pname , pi i s  t . 

pname  -  a  specific  entry  point  at  which  to  begin 
execution 

plist  -  list  of  parameters 

LGO,  name 

LOAD, lgo. 

EXECUTE. 


EXIT  Resume  processing  commands  after  a  previous  error. 

Syntax:  EXIT. 

Remarks:  When  used  in  a  procedure,  precede  it  with  a  SKIP 

or  REVERT,  because  EXIT  terminates  the  current 
and  all  calling  procedures  without  restoring  the 
registers . 
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See  also:  NOEXIT,  ONEXIT 

Similar  commands:  COS:  EXIT 

VMS:  ON  condition 

Examples:  FTN5. 

LGO. 

EXIT. 

COMMENT.  Program  failed. 


EXPLAIN  (IAF)  Retrieve  an  on-line  version  of  a  CDC  manual. 
Syntax:  EXPLAIN, M=manual 

EXP LAIN, manual 

Parameters:  manual  -  the  desired  manual 
See  also:  HELP,  HELPME 

Similar  commands:  VMS,  VMS  Cray  Station:  HELP 

NOS/VE:  EXPLAIN;  HELP 

Examples:  EXPLAIN. 


FCOPY  Convert  a  file  from  one  character  set  to  another. 

Syntax:  FCOPY, P=lfn,N=lfn,PC=cs ,NC=cs , PL=lt ,NL=lt , 

FL=f 1 ,LB=lb,R,A. 

Parameters:  P=  -  input  file  to  be  converted 

(default:  OLD) 

N=  -  output  converted  file 
(default:  NEW) 

PC=  “  character  set  of  input  file 

cs  meaning 

ASCII  6/12-bit  display  code  supporting 
ASCII  63-  or  64-char  on  current 
system 

ASCII8  7-bit  ASCII,  rt-just  in  12  bits 

ASCII88  8-bit  ASCII,  rt-just  in  8  bits 

ASCII63  6/12-bit  display  code  supporting 
ASCII  63-character  set 

ASCII64  6/12-bit  display  code  supporting 
ASCII  64-character  set 
8-bit  ASCII  on  S  tapes  (fixed 
line  length,  no  line  terminators) 


ASCFL 
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Remarks : 


DIS 

6~bit  display  code  supporting 

CDC  63-  or  64-char  on  current 
system 

DIS63 

6-bit  display  code  supporting 

CDC  63-character  set 

DIS64 

6~bit  display  code  supporting 

CDC  64-character  set 

EBCFL 

8~bit  EBCDIC  on  S  tapes  (fixed 
line  length,  no  line  terminators) 

(default : 

ASCII) 

output  character  set 

(default : 

ASCII8) 

PL=  -  input  line  terminator 


value 

meaning 

ZB 

zero  byte 

CR 

carriage  return 

FF 

form  feed 

LF 

line  feed 

US 

unit  separator 

RS 

record  separator 

CRLF 

carriage  return  and  line  feed 

LFCR 

line  feed  and  carriage  return 

n 

specified  octal  character 

(defaults:  most:  ZB; 

ASCI 188:  US; 

ASCFL,  EBCFL:  no  terminators) 

NL=  -  output  line  terminator 

(defaults:  same  as  for  PL=) 

FL=  -  length  of  fixed  length  lines  for  S  tapes 

(default:  80;  valid  only  for  ASCFL,  EBCFL) 

LB=  -  number  of  lines  per  block 

(default:  3840/ f 1 ;  valid  only  for  ASCFL, 
EBCFL) 

R  -  rewind  input  and  output  files  before  and 
after  processing 
(default:  no  rewind) 

A  -  abort  on  errors 

(default:  no  abort) 

Maximum  line  length  is  160  (12-bit  codes)  or 
320  (6-bit  codes) .  Longer  lines  are  truncated. 

Files  converted  to  7-bit  ASCII  can  be  printed 
on  a  Central  Site  printer  and  on  some  remote 
batch  printers.  They  cannot  be  listed  at  an 
interactive  printer. 
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FCOPY  does  not  write  an  end~of-file.  Use  WRITEF 
to  put  filemarks  in  a  multi-file  file. 

Similar  commands:  NOS/VE:  GET_FILE 

Examp 1 es :  FCOPY , P=my63 , PC=DIS63 , N=my64 , NC=DIS64 , R . 

A —  convert  NOS/BE  63-character  set 
file  to  NOS  64-character  set 
FCOPY , P=mya , N=mya8 . 

A—  convert  6/12-bit  ASCII  to  8/12- 
bit  ASCII  suitable  for  ROUTE-ing 
with  EC=A9  to  a  printer; 
for  input  to  Cray; 
for  FSE  directives  in  batch 
FCOPY, P= tape ,N=disk , PC=ASCFL,NC=DIS, FL=120, LB=30. 

A —  convert  ASCII  foreign  tape  of 

120-character  records  blocked  30 
to  an  internal  display  code  file 


FICHE  (DTRC)  Route  a  local  file  to  microfiche. 

Syntax:  BEGIN, FICHE, , lfn, title, comq, shift ,hdr . 

Parameters:  lfn  -  the  local  file  to  be  sent 

title  -  the  eye-readable  title  enclosed  in  $...$ 

comq  -  the  COM  (microfiche)  job  name 
(default:  COMQ) 

shift  -  0  -  carriage  control  is  in  column  1 
1  -  single-spaced  listing 
(default:  0) 

hdr  -  local  file  containing  a  non-standard 
header 

(default:  none) 

Remarks:  This  procedure  adds  a  standard  header  with  the 

COM  jobname  and  eye-readable  title.  If  your 
file  requires  a  non-standard  header,  put  it  into 
a  local  file  and  use  the  HDR  parameter. 

Similar  commands:  NOS/VE:  FICHE  (DTRC) 

VMS:  FICHE,  FICHEF,  FICHEFT,  FICHET 

(all  DTRC) 

Examples:  BEGIN, FICHE, , myout , $TEST  RUN  90/09/20$. 

A —  the  output  of  a  program 

BEGIN, FICHE, ,mydata,$TEST  DATA  90/09/20$ ,, 1 . 

A —  a  data  file  shifted 
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FILE  (CRM)  Describe  the  attributes  of  a  file. 

Syntax:  FILE, lfn, keys . 

FILE, lfn=xxxxxxx,keys . 

Parameters:  lfn  -  file  to  be  described 

=xxxxxxx  -  new  name  for  file 
keys  -  keyword  parameters  for  the  various 
attributes  and  their  values  —  some 
are : 

ASCII=  -  for  interactive  terminals 
0  -  64-char  display  code 

1  -  95-char  ASCII 

2  -  128-char  ASCII 
(default:  ASCII=0) 

BFS=  -  buffer  size 

0  -  system  provides  space 
n  -  octal  buffer  size 
(default:  BFS=0) 

BT=  -  block  type 

I  -  internal 
C  -  character  count 
K  -  record  count 
E  -  exact  record  count 
(default:  BT=I) 

CF=  -  close  file  action 

N  -  no  rewind 
R  -  rewind 

U  -  rewind  and  unload 
(default:  CF=N) 

CM=  -  conversion  mode 

NO  -  no  conversion 
YES  -  convert  external  to 
internal 

(default:  CM=N0) 

CNF=  -  connect  file  flag 

NO  -  disk  or  tape  file 
YES  -  terminal  file 
(default:  CNF=N0) 

DFC=  -  dayfile  control 

0  -  fatal  errors  to  dayfile 

1  -  errors  to  dayfile 

2  -  notes  to  dayfile 

3  -  errors  and  notes 
(default:  DFC=0) 

EFC“  -  error  file  control 

(same  as  DFC,  except  errors 
written  to  error  file 
ZZZZZEG) 
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E0=  -  parity  error  processing 

T  -  terminate  with  fatal 
error 

D  -  drop  bad  data 
A  -  accept  bad  data 
TD  -  same  as  T,  D,  A  plus 
DD  display  the  error 
AD  block  on  error  file 
ZZZZZEG 

(default:  EO=T) 

ERL=  -  trivial  error  count 
0  ~  no  limit 
n  -  number  of  trivial 
errors  to  accept 
(max:  551) 

(default:  ERL=0) 

FF=  -  flush  sequential  files  on 
abnormal  termination 
NO  -  buffers  not  flushed 
YES  -  output  scratch  file 
buffers  flushed 
(default:  FF=NO) 

FL=  -  fixed  length  (RT=T)  or  full 

length  (RT=Z) 

0  -  must  be  defined  for 
open 

n  -  decimal  length 

RT=F:  n  is  10-1310710 
RT=Z:  n  is  1-1310710 
(default:  F!=0) 

F0=  -  file  organization 

SQ  -  sequential 
WA  -  word  addressable 
(default:  FO=SQ) 

LCR=  -  label  creation  flag 

CRT  -  create  new  label 
CHK  -  check  existing  label 
(default:  LCR=CRT) 

LFN=  -  new  local  file  name 

LT=  -  label  type 

UL  -  unlabelled 
S  -  ANSI  !  andard 
NS  -  nonstandard 
ANY  -  any  label  type  (no 
user  processing) 
(default:  LT=UL) 
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Remarks : 


Similar 


Examples 


MBL=  -  maximum  block  length  (in 
characters) 

0  -  BT=I  -  5120 

BT=C  -  5120  (S  tapes) 
BFS~20(L  tapes) 
other  -  error 
n  -  length 

BT=K, E,RT=Z  -  >=  FL+10 
BT=I  -  MBL 

(default:  MBL=0) 

MRL=  -  maximum  record  length 
0  -  no  maximum 
n  -  maximum  number  of 
characters 
(max:  1310710) 

0F=  -  open  file  action 

N  -  no  rewind 
R  -  rewind 
(default:  0F=N) 

PD=  -  I/O  processing 

INPUT  -  read 
OUTPUT  -  write 
IO  -  read/write 
(default:  PD=INPUT) 

RB=  -  records  per  block  for  BT=K 

0  -  same  as  RB=1 
n  -  number  (max:  4095) 
(default:  RB=1) 

RT=  -  record  type 

W  -  control  word 
F  -  fixed  length 
R  -  record  mark 
Z  -  zero-byte  terminated 
D  -  decimal  character  count 
T  -  trailer  count 
U  -  undefined 
S  -  system-logical-records 
(default:  RT=W) 

Other  parameters  include:  BBH,  B8F,  CL,  CP,  Cl, 

HL,  LBL,  LL,  LP,  MFN,  MNB,  MNF,  MUL,  OMIT,  PC, 

PN0,  REL,  RMK,  SB,  SBF,  SPR,  TL,  ULP,  USE,  VF. 

commands:  NOS/VE:  ATTACH_FILE;  CHANGE_F I LE_ATTR IBUTES 

SET_F I LE_ATTR I BUTES 

:  FILE, PRT, BT=C ,RT=Z ,MRL= 150. 

A —  zero-byte  terminated  print  file 

FILE,STRANGR,BT=K,RT=F,RB=10,MRL=aU,MbL=8UU,EO=A, 
ERL=25 , BFS=512 , CM=YES . 

A —  stranger  blocked  coded  tape 

FILE, INPUT, LFN=DATA. 

A —  substitute  alternate  input  file 
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FLR  (DTRC)  Compile  FTN5 ,  load  with  up  to  2  lib  raries,  and  run. 

Syntax:  BEGIN, FLR, ,fyle,abs, libl,lib2, norun. 

Parameters:  fyle  -  Fortran  77  source  file 

abs  -  to  hold  the  absolute  program 
(default:  ABS) 

libl  -  optional  first  library  for  use  in  loading 

lib2  -  optional  second  library 

norun  -  non-null  to  inhibit  program  execution 

Similar  commands:  VMS:  FLR 

Examples :  BEGIN, FLR, , my sore , my abs . 

A —  create  absolute  and  execute 

BEGIN, FLR, .rnysorc ,myabs , , ,x. 

A —  make  absolute  but  don't  execute 

BEGIN, FLR, ,mysorc, ,dtlib. 

A —  load  using  library  DTLIB  (you  do 
not  have  to  ATTACH  this  first) 

ATTACH, myl ib . 

BEGIN, FLR, , rnysorc, ,mylib, DTLIB. 

A--  load  using  libraries  MYLIB  and 
DTLIB  in  that  order 


FORM  File  Organization  and  Record  Manager. 

Syntax:  FORM, I=dirfyl , B=owncode . 

Parameters:  1=  -  directive  file 

(default:  INPUT) 

B=  -  owncode  routines  to  be  loaded 
(default:  B=0) 

Directives:  Parameters  for  sequential  files  are  shown 

(additional  parameters  are  available): 

Input  file:  INP  (1  f  n ,  P0S=‘| — n,MAX=n,REW=r) 

lfn  -  the  input  file 

P0S=  -  skip  n  logical  records  forward  or 
backward  before  processing 
(range:  1-16383;  default:  no  limit) 

MAX=  -  maximum  number  of  records  to  be  processed 
(range:  1-8,388,607;  default:  no  limit) 
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REW=  -  rewind  at  end 

N  -  no  rewind 
R  -  rewind 

U  -  rewind  and  unload  (tape) 

(default:  R;  ignored  for  INPUT) 

Output  file: 

OUT (1 f n , POS=+-n , MAX=n , REW=r , BGD=g , SEL=a) 

lfn  -  the  output  file 

(up  to  20  OUT  files  may  be  specified) 
(default:  OUTPUT) 

P0S=  -  same  as  for  INP 
MAX=  -  same  as  for  INP 
REW=  -  same  as  for  INP 

(default:  R;  ignored  for  OUTPUT,  PUNCH, 
PUNCHB) 

BGD=  -  preset  output  record 
X  -  blank  (55B) 

N  -  display  code  zero  (33B) 

B  -  binary  zero 
E  -  floating  point  zero 
C  ~  same  as  input  record 
(default:  B) 

SEL=  -  selection  criteria 

ALL  -  copy  all  records  with  QAL 
processing  as  requested 
QRO  -  copy  only  records  meeting  QAL 
criteria 

(default:  SEL=QR0) 

Non-standard  label:  NON (lfn, ORD=n , LEN=n , LBL= lit) 

Record  qualif ication:  QAL (lfn, condition) 

Record  reformatting:  REF(lfn, entry, entry, .. ,) 

entry  -  out_iTm=in_iTm  -  move  input  field  to 

output  field 

out_iTra=l i teral  -  put  literal  into 

output  field  of  all 
records 

iTm  -  field  specification 

i  -  initial  position  (decimal) 

T  -  field  type 

X  -  character 

(also:  E,  D,  U,  I,  S,  N,  Z) 
m  -  length 

literal  -  dollar-delimited  ($...$) 
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Print :  PRT (if n, FMT=f , PGL=n, TOP=n , TTL=1 i t) 

lfn  -  the  output  file 
FMT=  -  line  spacing 

1  -  single  space 

2  -  double  space 

3  -  triple  space 

A  -  first  character  of  line  is 
carriage  control 

D  -  dump  the  lines  single  spaced,  100- 
character  lines 

PGL=  -  number  of  print  lines  (including  the 
title  line)  per  page 
(max:  60  (f=l) ,  30  (f=2) ,  20  (f=3) ; 
default:  60/f) 

T0P=  -  line  of  page  for  the  title 

(range:  2-60;  defaults:  1  (TTL  omitted), 

2  (TTL  given)) 

TTL=  -  the  page  title  (up  to  136  characters) 
(ignored  for  f=D) 

IBM  S/360  magnetic  tape  conversion: 

CON (lfn,RID=l i t ,descr . . . ,RID=1 i t , descr . . .) 

Execute:  XEQ (ERR=e ,COL=l i t , . . . ,FIN) 

ERR=  -  error  processing  for  unrecovered  tape 
parity  errors: 

ASV  -  abandon  FORM  run 
ANO  -  abandon  FORM  run;  get  rid  of 
output  disk  files,  OUTPUT  and 
any  partially  written  tapes 
remain 

CSV  -  continue,  accept  bad  block, 
dump  bad  block  to  ZZZZZEF 
CNO  -  continue,  delete  bad  block, 
dump  bad  block  to  ZZZZZEF 
C0L=  -  alternate  collating  sequence 

(up  to  64  characters;  those  not 
specified  collate  equal  and  higher  than 
the  highest  specified) 

Remarks:  FORM  has  many  functions  including  reblocking 

sequential  files. 

FORM  may  also  be  called  from  a  Fortran  or  Cobol 
program. 

FILE  statements  are  used  to  describe  the  file 
blocking. 

See  also:  FCOPY  (much  easier  to  use) 

Similar  commands:  NOS/VE:  FILE  MANAGEMENT  UTILITY 
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FORTRAN 


FSE 


(IAF)  Select  the  FORTRAN  subsystem. 
Remarks:  Use  FSE  and  FTN5. 


Invoke  the  full-screen  editor. 


Syntax :  FSE, FN=f i 1 e ,OP=access , 1= input , L= out put , 

IP=procedure , WF=workf i 1 e. direct ives 

FSE, file, access, input .output, procedure, 
work file. directives 


Parameters:  FN=  -  local  or  permanent  file  to  be  edited 

(Default:  most  recently  edited  file  during 
job) 


OP=  -  character  set  code  and  file  location 


access 

abb 

meaning 

DISPLAY 

D 

6-bit  display  code 

or 

(default  if  your  terminal 

NORMAL 

N 

is  in  NORMAL  mode) 

ASCII 

A 

6/12-bit  display  code 
(default  if  your  terminal 
is  in  ASCII  mode) 

ASCII8 

8 

7~bit  ASCII  right-justif i 
in  12  bits) 

GET 

G 

access  an  existing  file 
(may  be  used  with  above) 

1=  ~  input  directive  file 

(Default:  INPUT) 

0=  -  output  listing  file 

(Default:  OUTPUT) 


IP=  -  alternate  FSE  procedure  library 
(Default:  FSEPROC) 

WF=  -  alternate  FSE  work  file 
(Default:  ZZZWORK) 


dir  -  initial  directives 

(use  to  separate  directives) 


See  also:  DTRC/CMLD-88/15 ,  "CDC  NOS  Full  reen  Editor 

(FSE)  User's  Guide" 


Similar  commands:  NOS/VE:  EDIT_FILE 

VMS:  EDIT/EDT;  EDIT/TPU  (EVE) 
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FTN5 


Examples:  FSE.myf i le,G. 

FSE. 


< —  GET/ATTACH  existing  file 
edi  t 

< —  resume  previous  editing 
session 


to 


Compile  Fortran  77  program. 

Syntax:  FTN5 , ANSI=ans i , B=b ,BL=bl ,CS=cs ,DB=db ,DO=do ,DS=ds , 

E=e , EL=el , ET=et , G0=go, I=i , L=1 , LO= 1 o , MD=md , 
OPT=opt , PD=pd, PL=pl ,PN=pn, PS=ps , PW=pw,QC=qc , 
REW=rew, ROUND=round, SEQ=seq . 


Parameters:  ANSI=T 
ANSI=F 
ANSI 
ANSI=0 
omitted 


Flag  Non-ANSI  (trivial) 
Flag  Non-ANSI  (fatal) 
Same  as  ANSI=T 
No  ANSI  diagnostics 
Same  as  ANSI=0 


B=PUNCHB 

B=lfn 

B 

B=0 

omitted 


Produce  punched  binary  decks  of  all 
routines 

Put  binary  into  a  file 
Same  as  B=BIN 
No  binary  output 
Same  as  B=LG0 


BL 


BL=0 


omitted 


Burstable  list  (each  major  compilation 
section  starts  on  a  new  page) 

Compact  list  (new  page  for  first  page 
only 

Same  as  BL=0 


CS=FIXED 

CS=USER 

CS 

omitted 


Collating  sequence  fixed  weight  table 
(display  code) 

Weight  table  is  user-defined  by 
subroutines  COLSEQ,  WTSET,  CSOWN 
Same  as  CS=USER  (at  DTRC) 

Same  as  CS=FIXED  (at  DTRC) 


DB=op/op/...  Debugging  options 

(ARG=FIXED  not  allowed) 
op  meaning 


ER 

ID 

PMD 

SB 

SL 

ST 

TB 


generate  code  for  object-time 

reprieve  of  errors 

generate  output  for  interactive 

debug  (requires  0PT=0) 

post  mortem  dump  facility  is 

used 

check  subscript  bounds 
check  character  substring 
expressions 

same  as  DB=ID  but  no  stylized 

object  code 

full  error  traceback 


90/09/30 


RevO 


Page  1-53 


DB 

DB=0 

omitted 

DO=op/ op 


DO 

D0=0 

omitted 

DS 

DS=0 

omitted 

E-lfn 

E 

omitted 

EL=C 

EL=F 

EL=W 

EL=T 

EL 

omitted 

ET=C 


ET=F 

ET=W 

ET=T 

ET 

ET=0 

omitted 

GO 

G0=0 

omitted 

I  =  1  f  n 
I 

omitted 


Same  as  DB=ER/ID/PMD/SB/SL/ST/TB 
All  options  deselected 
(DB=-ER/-ID/-PMD/-SB/-SL/-ST/-TB) 
Same  as  DB=0  (if  0PT=1,2,3) 

Same  as  DB=ER  (if  OPT=0) 

DO-loop  interpretation 
op  meaning 


LONG  trip  count  may  be  >  131,071 
OT  at  least  once  through  each  DO 

loop 

Same  as  D0=0T 

Trip  count  must  be  <=  131,071  and 
minimum  trip  count  is  0 
Same  as  D0=0 

All  C$  directives  ignored 
All  C$  directives  processed 
Same  as  DS=0 

Output  error  list  (see  EL)  on  file  lfn 
Same  as  E=ERRS 
Same  as  E=OUTPUT 

List  catastrophic  errors 
EL=C  plus  fatal  errors 
EL=F  plus  warning  errors 
EL=W  plus  trivial  errors 
Same  as  EL=F 
Same  as  EL=T 

Abort  job  if  catastrophic  errors  during 
compilation;  next  control  statement  to 
be  executed  is  the  one  after  EXIT(S); 
if  no  EXIT(S),  job  ends 
Abort  job  if  fatal  or  higher  errors 
Abort  job  if  warning  or  higher  errors 
Abort  job  if  trivial  or  higher  errors 
Same  as  ET=F 

Continue  even  if  compilation  errors 
Same  as  ET=F  (at  DTRC) 

Load  and  execute  object  code  without  a 
separate  LGO  (B=0  and  QC  not  allowed) 

Do  not  load  and  execute 
Same  as  G0=0 

FORTRAN  source  input  is  in  lfn 
Same  as  I=C0MPILE 
Same  as  I=INPUT 
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L=lfn 

Output  lists  (BL,  LO)  to  file  lfn 
(see  also  E  option) 

L=0 

Listings  are  suppressed 

L 

Same  as  L=LIST 

omitted 

Same  as  L=0UTPUT 

LO=op/ op/ 

. ..  Listing  options  (see  L  parameter) 
op  meaning 

A  list  of  variables,  common  blocks 

and  attributes 

H  address  map 

0  object  code  list  (use  only  at 

request  of  User  Services) 

R  cross-reference  map 

S  source  code  list 

LO 

Same  as  L0=S/A/R 

LO=0 

No  A,  M,  0,  R,  S  information 

omitted 

Same  as  L0=S/A 

MD=T 

Flag  machine-dependent  usage  (trivial) 

MD=F 

Flag  machine-dependent  usage  (fatal) 

MD=0 

No  machine-dependent  diagnostics 

omitted 

Same  as  MD=0 

OPT=0 

Fast  compile  (required  by  DB=ID) 

OPT=l 

Intermediate  optimization 

0PT=2 

High  optimization,  slow  compile 

OPT=3 

0PT=2  plus  potentially  unsafe 
optimization 

OPT 

Same  as  OPT=2 

omitted 

Same  as  OPT=0 

PD=8 

Print  density  (E,  L  listings  at  8 
lines  per  inch) 

PD=6 

E,  L  listings  at  6  lpi 

PD 

Same  as  PD=8 

omitted 

Same  as  PD=6 

PL=<n> 

Print  limit  (decimal  maximum  number  of 
records  to  be  written  at  execution  time 
on  file  OUTPUT)  —  may  be  reset  at 
execution  time  by  specifying  ,vPL=n, 
where  n  is  the  new  line  limit,  at  the 
end  of  the  execute  statement 
(max:  9  999  999  999) 

PL 

Same  as  PL=50000 

omi t  ted 

Same  as  PL=5000 

PN 

Page  numbering  of  output  list  is 
continuous 

PN=0 

Each  subprogram  starts  with  page  1 

omitted 

Same  as  PN=0 
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PS=n  Page  size  (number  of  lines  per  page 

in  compilation  listing)  (n  >=  4) 
omitted  Same  as  PS=80  (if  PD=8) 

Same  as  PS=60  (if  PD=6) 

Page  width  (number  of  characters  per 
line  in  compilation  listing) 

(50  <=  n  <=  136) 

Same  as  PW=72 

Same  as  PW=72  (if  L  or  E  file  is 
connected) 

Same  as  PW=136  (all  other  files) 

QC  Quick  syntax  check  (no  binary  output 

or  cross  reference  addresses) 

(conflicts  with  B,G0,L0=0/M) 

QC=0  No  quick  syntax  check 

omitted  Same  as  QC=0 

REW=op/op/ . . .  Rewind  option 
op  meaning 

B  rewind  binary  output  file 

(object  code) 

E  rewind  error  file 

I  rewind  input  file 

L  rewind  output  file 

REW  Same  as  REW=I/B 

REW=0  No  files  rewound 

omitted  Same  as  REW=0 

ROUND=op/op/ . . .  Rounded  arithmetic  for 
specified  operators 

(op  is  one  of:  A,  S,  M,  D,  for  +,  *, 

and  /,  respectively) 

ROUND  Same  as  ROUND=A/S/M/D  (at  DTRC) 

ROUND=0  Rounded  arithmetic  not  used 

omitted  Same  as  R0UND=A/S/M/D  (at  DTRC) 

SEQ  Sequenced  line  format 

SEQ=0  Standard  FORTRAN  format 

omitted  Same  as  SEQ=0 

Defaults:  FTN5 , ANSI=0, B=LG0 , BL=0, CS=FIXED,DB=ER , DO=0,DS=0, 

E=OUTPUT,EL=T,G0=0, I=INPUT, L“0UTPUT, L0=S/A, 
OPT=0, PD=6 , PL=5000, PN=0, PS=60, PW= 136 , QC=0, 
REW=0 , ROUND=A/ S/M/D, SEQ=0 . 

Similar  commands:  COS:  CFT;  CFT77 

NOS/VE,  VMS:  FORTRAN 

Examples:  FTN5 , I=myprog , L=0, GO.  < —  compile  and  go  with 

no  listing 


PW=n 

PW 

omitted 
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GET 


GETASC 


Get  copies  of  indirect  permanent  files  as 

Syntax:  GET, lfn_l=pfn_l , lfn_2=pfn_2, 

/UN=un,PW=pw,NA,RT. 


local  files. 

. . , 1 fn_n=pfn_n 


See  also:  ATTACH,  FETCH  (Cray) 

Similar  commands:  NOS/VE:  ATTACH_FILE 

Examples:  GET,myindfl. 

GET, herindf /UN=her_un, PW=her_pw. 


(DTRC)  Get  an  indirect  or  direct  8/12  ASCII  file  and  convert 
to  6/12  Display  Code. 


Syntax:  BEGIN, GETASC, , FN=fn, 0=1 fn. 

Parameters:  FN=  -  name  of  8/12-ASCII  permanent  (indirect  or 

direct)  file 

0=  -  name  of  6/12-bit  Display  Code  local  file 

Remarks:  This  is  useful  in  getting  ASCII  files  from  the 

VAXcluster  which  were  stored  on  the  MSS  using 
HFT  STORE  /ASCII. 

See  also:  PUTASC 


Similar  commands:  VMS:  HFT  FETCH  /ASCII 


Examples : 


HFT  STORE  /ASCII  myvaxf i 1 e . f or  myvaxf 
BEGIN, GETASC, , myvaxf .myvaxf . 

A—  local  file  MYVAXF  will  contain 
6/12-bit  Display  copy  of  the 
8/12-bit  ASCII  file  MYVAXF 


a 
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GETATT  (DTRC)  Get  an  indirect  file  or  attach  a  direct  file. 

Syntax:  BEGIN, GETATT, , FN, UN, PW, LOG. 

Parameters:  FN  -  the  name  of  the  file 

UN  -  required  for  file  in  another  catalog 

PW  -  required  if  UN  is  specified  and  the  file 
has  a  password 

LOG  -  controls  the  display  of  a  message  telling 
whether  the  file  is  indirect  or  direct 
log  meaning 


Y  display  the  message 

(synonyms:  YE,  YES) 

N  do  not  display  the  message 

(synonym:  NO) 

(default:  N;  only  keyword:  Y) 

See  also:  GET,  ATTACH 

Examples :  /BEGIN, GETATT, ,myf i le , , ,y . 

MYFILE  is  a  direct  file 
/BEGIN, GETATT, , hisf ile,abcd,hispw,  log. 
HISFILE/UN=ABCD  is  an  indirect  file 
/BEGIN, GETATT, ,herf ile, efgh. 

/ 


GO  Clear  the  pause  bit  of  one  of  your  jobs. 

Syntax:  G0,jsn. 

Remarks:  The  pause  bit  may  be  set  by  one  of  your  programs 

or  by  the  PAUSE  command. 

See  also:  PAUSE 

Examples:  G0,AAXJ. 


GOODBYE  Terminate  an  application. 

Syntax:  GOODBYE, application 

Remarks:  GOODBYE  can  appear  in  a  procedure  or  a  batch  job, 

where  it  terminates  the  job. 
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GRIPE 


See  also:  BYE,  LOGOUT;  HELLO,  LOGIN 

Similar  commands:  COS:  AZ,QUIT 

VMS:  LOGOUT 

Examples:  GOODBYE 


(DTRC)  On-line  gripe/suggestion  facility. 

Syntax:  BEGIN, GRIPE, , OPT, I ,L=OUTPUT. 

Parameters:  OPT  -  option 

S  -  short  interactive  prompt  messages 

(default:  longer  prompting  messages) 

I  -  optional  input  local  file  containing  your 
prepared  comments 

(default:  you  will  be  asked  later  for  a 

filename  or  that  you  will  enter 
them  at  the  keyboard) 

L  -  after  all  the  information  has  been  gathered, 
this  file  will  contain  a  copy  of  your 
comments 

(default:  OUTPUT) 

Remarks:  This  procedure  executes  a  program  which  gathers 

the  information  and  sends  it  to  us.  It  may  be 
executed  interactively  or  in  a  batch  job.  When 
executed  in  batch,  the  data  record  must  contain 
the  following  in  the  indicated  order: 
line  cols  contents 


1 

2 

3 

4 


5 


6 


1-4  your  User  Initials 
1-40  your  name 
1—10  your  DTRC  code 
or 

1-37  your  non-DTRC  company  and  address 
1-20  your  telephone  number 

4  digits  -  DTRC/Annapol is  extension 

5  digits  -  DTRC/Carderock  extension 
7  digits  -  DC  area  (202)  phone  # 

10  digits  -  area  exchange  number 
If  you  include  an  extension,  use  10 
digits  followed  by  the  extension 
1-10  blank  line  -  not  a  refund  request 
non-blank  -  10-digit  job  order 
number  for  refund 
request 

1-2  Cray  Station  ID  (Cl,  Nl,  V,  V3-V4) 
or 

1-5  Site  Code  (MFN,  VAX,  DT3-DT4) 
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GTR 


7  1-40  Supporting  documentation  (such  as 

"PRINTOUT  AND  DUMP") 

(blank  line  if  none) 

8  on  1-70  your  comments 

(up  to  20  lines  —  excess  truncated) 


Similar  commands:  VMS:  GRIPE 


Examples : 


Batch: 

/JOB 

myjob. 

/USER 

/CHARGE 

BEGIN, GRIPE. 

/EOR 

ZMDS 

JOE  USER 

3511 

71234 


< —  User  Initials 
< —  name 
< —  DTRC  code 
< —  Carderock  extension 


< —  not  a  refund  request 
Nl  < —  gripe  about  CDC  860 

< —  no  supporting  info 
THIS  IS  WHERE  THE  DESCRIPTION 
OF  THE  PROBLEM  GOES  -  LIMITED  TO 
20  LINES 


Selective  extraction  of  records  from  a  (library)  file. 

Syntax:  GTR, lfn_l , lfn_2, d,NR, S ,NA. dir_l , dir_2, . . . , dir_n 

Parameters:  lfn_l  -  source  file 

(Default:  OLD) 

lfn_2  -  output  file  (must  be  disk  if  "d"  used) 
(Default:  LG0,  positioned  at  EOI  (disk) 
or  BOI  (tape,  unless  NR) 

d  -  random  access  directory 

omitted  -  no  new  random  access 

directory;  if  ULIB  type, 
first  record  not  copied, 
rest  of  records  copied;  last 
record  of  OPLD  copied  without 
alteration;  no  EOF  written  at 
end  of  file 

U  -  no  new  random  access 

directory;  if  ULIB  type, 
first  record  copied  without 
alteration  with  rest  of 
library  and  OLPD;  no  EOF 
written  at  end  of  file 
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D  -  write  random  access  directory 

on  lfn_2  with  entries  for 
selected  records;  if  ULIB 
type,  first  record  copied 
without  alteration  with  rest 
of  library  and  OPLD;  EOF 
written  after  new  directory 
other  -  same  as  D 

NR  -  do  not  rewind  lfn_l  after;  do  not  rewind 
lfn_2  before  or  after;  copy  an  existing 
directory  from  lfn_l  to  lfn_2 

S  -  search  lfn_l  sequentially 

NA  -  do  not  abort  on  error 

dir_i  -  a  record  or  group  of  records  to  get: 
type/name 
name 

type_l/name_l-type_2/name_2 

type_l/name_l-name_2 

name_l-name_2 

type/name-*  (all  type  from  name  on) 

name-*  (all  from  name  on) 

type/*  (all  of  type) 

*  (all  records) 

0  (insert  zero-length  record) 

See  also:  LIBEDIT 

Similar  commands:  COS:  BUILD 

VMS:  LIBRARIAN 

Examples:  GTR, SYSTEM, BIN, D.PP/* 

A —  copy  all  PP  records,  build  random 
access  directory 

GTR , OPL , NEW , , NR . OPLC/COMCARG , 0 , COMCCIO 

A —  copy  2  records  and  put  a  zero- 
length  record  in  between  them  at 
the  current  position  of  NEW;  NEW 
not  rewound,  OLD  rewound  before 
GTR, SYSTEM, SYSLIB.D.ULIB/SYSLIB 

A —  user  library  SYSLIB  copied  from 
file  SYSTEM  to  end  of  SYSLIB 
GTR.REL/A  < —  copy  record  A  from  OLD  to  LGO 


HELLO  (IAF)  Logs  you  out  of  IAF  and  switches  you  to  another 
application,  or  starts  another  login. 

Syntax:  HELLO, application 

Remarks:  If  IAF  is  a  secondary  application,  HELLO, appl  is 

the  same  as  BYE, appl. 
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If  application  is  omitted,  a  new  login  is 
started. 

See  also:  LOGIN;  BYE,  GOODBYE,  LOGOUT 

Similar  commands:  VMS:  LOGOUT  then  reconnect 

Examples:  HELLO, ICF  < —  switch  to  Interactive  Cray 

Facility 


HELP 


(IAF)  Ask  for  help. 


Syntax: 
Remarks : 


HELP. 

Displays  a  menu  and  prompts  for  your  selection. 
Help  features: 

.  list  of  all  NOS  commands,  except  compiler 
calls 

.  help  in  entering  a  command 
.  access  to  on-line  CDC  manuals 
.  list  of  NAM/CCP  network  commands 


See  also:  EXPLAIN,  HELPBE,  HELPME 

Similar  commands:  NOS/VE,  VMS:  HELP 


Examples:  HELP. 


HELP 


(DTRC)  Obtain  help  on  DTRC  additions  to  NOS  or  other  topics. 


Syntax:  BEGIN, HELP, ,T,L. 

Parameters:  T  -  the  name  of  the  command,  (sub) program, 

procedure,  or  other  topic  for  which  help  is 
desired  —  the  following  provide  help  about 
this  procedure: 

CONTENT  -  a  list  of  the  available  topics 
?  -  how  to  use  this  procedure 

L  -  output  file 

(Default:  L=0UTPUT) 


Remarks:  Some  help  modules  are  pages  from  CCRM  and  may  be 

printed  or  BEGIN , AUXPRNT-ed  and  inserted  into  the 
manual . 

Most  help  modules  are  6/12  ASCII. 


Similar  commands:  VMS:  HELP 
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Examples:  BEGIN, HELP, .CONTENT. 

A —  a  iist  of  the  available  helps 


BEGIN, HELP, , FTP, out. 

A —  help  on  FTP  (File  Transfer 
Protocol)  written  into  local 
file  OUT 

BEGIN , XEROX , , out , JOB=DOCPRT , ASCI 1= YES . 

A —  print  6/12  ASCII  file  on  Xerox 

HELPBE  On-line  help  for  the  NOS-equivalent  of  NOS/BE  commands. 

Syntax:  HELPBE. 

Remarks:  HELPBE  is  in  library  BETONOS/UN=LIBRARY. 

Examp 1 es :  ATTACH , USRL I B8=BETONOS/UN= LIBRARY . 

LIBRARY, USRLIB8/A. 

HELPBE.  < —  you  will  be  prompted 

LIBRARY, USRLIB8/D. 

HELPME  (IAF)  Display  a  brief  description  of  a  command,  prompt  for 
parameters,  execute  the  command. 

Syntax:  HELPME, command 

Parameters:  command  -  the  command  you  want  help  with 

Remarks:  This  is  an  interactive  procedure.  Enter  a 

question  mark  (or  the  HELP  function  key  in  screen 
mode)  at  any  time  for  help  during  the  dialog. 

See  also:  EXPLAIN,  HELP,  HELPBE 

Similar  commands:  NOS/VE:  DISPLAY_COMMAND_INFORMATION; 

DISPLAY_COMMAND_PARAMETERS 
VMS  Cray  Station:  HELP 

Examples:  HELPME, FCOPY. 


IF  Conditionally  skip  one  of  more  commands. 

Syntax:  IF, condition. command.  < —  note  two  terminators 

IF, condition, label. 


Synonym: 


IFE 
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ITEMIZE 


Parameters:  condition  -  an  expression  evaluating  to  true  or 

false 

command  -  a  valid  command 

label  -  alphanumeric  string  ( 1 — 1 0  characters, 
starting  with  a  letter) 

Similar  commands:  COS,  NOS/VE,  VMS:  IF 

Examples:  IF (R 1=1 , there) 

ENDIF (there) 

IF, Rl=l. REWIND, fyle. 


List  information  about  each  record  of  a  binary  file. 

Syntax:  ITEMIZE, lfn, L=1 is tfyl , BL ,PW=n, PD,NR,N=n, E, U. 

Parameters:  params  -  optional  parameters: 

BL  -  burstable  listing  (new  page 
for  each  file  output) 

E  -  list  entry  points  for 
relocatable  modules; 
list  IDENTs  for  UPDATE 
sequential  PL 

L=  -  the  output  listing,  if  other 
than  OUTPUT 

N  -  process  to  end-of-inf ormation 

N=n  -  number  of  files  to  process 
(default:  1) 

NR  -  lfn  not  rewound  before  or 
after 

PD  -  print  density  is  8  lpi 
(default:  6  lpi) 

PW=pw  -  page  width 
(defaults: 
batch:  136  or  72 
IAF:  72  (output  file 

connected) 

136  (output  file  not 
connected) 

U  -  itemize  all  records  in  a  user 
1  ibrary 

(default:  only  user  library 
directory) 


Remarks:  Output  includes  record  number,  name,  length, 

prefix  table  for  relocatable  binary  or  user 
1 ibrary. 

For  a  sequential  UPDATE  PL,  only  deck  names  are 
listed. 
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Your  terminal  should  be  in  NORMAL  mode  (not 
ASCII)  before  listing  ITEMIZE  output  at  your 
terminal . 

Defaults:  ITEMIZE, LGO, L=OUTPUT,N=l , PW=see  above. 

See  also:  CATALOG 

Similar  commands:  COS:  ITEMIZE 

NOS/VE:  ANALYZE_OBJECT_LIBRARY; 

DISPLAY_OB JECT_LIBRARY 
VMS:  LIBRARIAN 

Examples:  ITEMIZE, oldpl . 

ITEMIZE,userlib,U,L=uout . 


job  Identifies  requirements  for  a  batch  job. 

Syntax:  ujn, SC=sc , T=t ,CM= cm, ST=1 id. punchmode 

ujn, SCsc , Tt , CMcm, ST1 id. punchmode 
ujn, sc , t , cm, 1 id. punchmode 

‘  ujn,P=p,T=t ,CM=cm,ST= lid. punchmode 

ujn , Pp , Tt , CMcm, ST lid. punchmode 
ujn,p, t , cm, lid. punchmode 

Parameters:  sc  -  do  not  use  at  DTRC 

p  -  priority  (2,  3,  4) 

(higher  priority  means  higher  cost) 
(default:  2) 

t  ~  job  step  time  limit  in  CPU  seconds 
(Range:  1  to  32767  decimal; 

1  to  77777B  octal) 

(Default:  64  decimal) 

cm  -  maximum  octal  field  length  required 
(Maximum:  376500  octal) 

(Default:  376500  octal) 

lid  -  not  used  at  DTRC 

punchmode  -  in  columns  79-80  of  actual  punched 
cards 

26  -  026  mode 

29  -  029  mode 

Similar  commands:  COS:  JOB 

Examples:  ABCDjbl ,CM75000,T10.  < —  these  three 

ABCDjbl  ,CM=75000,T=10.  <—  are  the 

ABCDjbl ,, 10, 75000.  < —  same 


ABCD. 


< — 


all  defaults 
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JOBCOST  (DTRC)  Display  the  job  cost,  SRUs  used,  and  CPU  time  in  the 
dayfile  and  file  OUTPUT. 

Syntax;  BEGIN, JOBCOST. 

Similar  commands:  COS:  JOBCOST 

VMS:  AT 

Examples:  BEGIN, JOBCOST. 

MYPROG. 

BEGIN, JOBCOST. 

A —  the  difference  is  the  cost  of 
running  program  MYPROG 


KERMIT  (DTRC)  Transfer  files  to/from  microcomputers. 

Syntax:  GET , KERMIT/UN=NSYS . 

KERMIT. 

Remarks:  You  must  have  KERMIT  on  your  PC  (it  might  be  a 

subset  of  PROCOMM) . 

See  also:  FTP;  XMODEM 

Similar  commands:  NOS/VE:  KERMIT 

VMS:  FTP;  KERMIT 


LABEL  Mount  a  magnetic  tape  and,  if  labelled,  check  the  label. 

Syntax :  LABEL, lfn , VSN=vsn_l/vsn_2= . . . =vsn_n- 1 /vsn_n , 

D=den,F=format,LB=lb, 

FC=f  count , CV=cv, NS=ns , P0=plp2 . . . pn , CK  J CB , 
SI  =  setid]M=setid, SN=s  ecno , QN=  seqno , 

L=f i 1 e id ■ FA=fa, G=genno , E=gvn , 
CR=cdate|C=cdate, RT=yyddd i T=ddd,W|R, 

AC=ac , CT=ct , PW=pw, 

T0=  t  o , UN=us  ername . 


Required  parameter:  lfn  -  local  file  name  for  the  tape  - 

if  lfn  is  already  a  local  disk 
file,  processing  continues  -  if  lfn 
is  already  a  mounted  tape  and  R  is 
present,  the  label  is  checked 


AC= 

-  a  1 1 erna t e  aud 

i tabi 1  i  ty 

CK 

-  lfn  i 

s  t o  be 

used  as  a 

checkpoint 

CB 

CK 

-  append 

dump  to 

lfn 

CB 

-  write 

dump  at  BOI  of  lfn 

CR  = 

-  creat 

ion  date 

Cyyddd) 

C- 

CT  = 

-  file 

category 
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CV=cv  -  conversion  mode  for  9-track  (NT)  labels 


cv 

meaning 

AS 

ASCIl/6-bit 

display  code 

US 

same  as  AS 

EB 

EBCDIC/ 6~bi t 

display  code 

tape  density 

MT 

NT 

den 

dens i ty 

den 

dens i ty 

L0 

200  cpi 

HD 

800  cpi 

HI 

556  cpi 

PE 

1600  cpi 

HY 

800  cpi 

GE 

6250  cpi 

200 

200  cpi 

800 

800  cpi 

556 

556  cpi 

1600 

1600  cpi 

800 

800  cpi 

6250 

6250  cpi 

E=  -  1-  to  4-digit  generation  version  number 

(Default:  0) 


F=  -  data  format 


format 

meaning 

I 

internal 

SI 

system  internal  (NOS/BE  tape) 

s 

stranger 

L 

long  block  stranzer 

F 

foreign  (unknown  data  format) 

(Default : 

F-I) 

File  accessibility  character 

fa 

meaning 

blank 

unlimited  access 

A 

only  the  owner  can  access  it 

other 

future  accesses  must  specify 
this  character 

FC=  -  maximum  block  size  in  frames  (required 
if  F=F  is  specified) 

G=  -  1-  to  4-digit  generation  number 

(Default:  1;  0  not  allowed) 

L=  -  1-  to  -17-character  file  label 

(Default:  blank) 

LB=lb  labelled  or  unlabelled  tape 


lb 

meaning 

KL 

ANSI-labelled 

KU 

un  1  abe 1 1 ed 

NS 

nonstandard-label  led 
(assumes  data  starts 

i mmed i a  t  e 1 y 

after  the  first  tape 

mark) 
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NS=ns  -  noise  size  ''any  block  shorted  than  ns 

frames  is  discarded);  not  valid  for  F=I, 

F=SI;  D=PE ,  or  D=GE 

(Maximum:  31;  NS=0  ==>  the  default; 

Defaults:  0  (PE,GE),  18  (others)) 

PO=  -  processing  options 
po  meaning 

R  Read  the  tape  (ring  OUT) 

W  Write  the  tape  (ring  IN) 

L  List  only  first  and  last  error 

messages  for  each  bad  tape  block 
Options  may  be  combined  (e.g.,  WL) . 
Several  other  options  are  available. 

PW=  -  password 

QN=  -  l-  to  4-digit  file  section  number  of  the 
file  within  a  multi-file  set 
(Default:  1;  use  QN=9999  to  append  a  new 
file  to  a  multi-file  set) 

R  '  -  read  the  label  and  check  specified  fields 

W  -  write  a  new  label,  if  the  existing  label 

has  expired 

(Default:  R;  ignored  for  F=SI  and  QN>1) 

RT=  -  retention/expiration  date  (yyddd) 

T=  -  retention  number  of  days  (0  to  999) 

SI=  -  1-  to  6-character  file  set  identifier 

(required  for  file  positioning  in  multi¬ 
file  set)  —  usually  use  the  tape's  VSN. 
(see  page  1-5-1) 

SN=  -  1-  to  4-digit  file  section  number  of  the 
volume  within  a  multivolume  file  set 
(Default:  1) 

TO=  -  TMS  option 

UN=  -  user  name 

VSN=  -  1-  to  6-character  volume  serial  number 

/  “  separates  multiple  reels 

=  -  use  first  available  VSN 
(Default:  from  separate  VSN  statement 
preceding  LABEL) 

See  also:  VSN 

Similar  commands:  COS:  ACCESS 

NOS/VE :  CHANGE_TAPE_LABEL_ATTR I BUTES ; 

REQUEST_MAGNETIC_TAPE 
VMS:  REQUEST, MOUNT 
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Examples:  LABEL, tbe , VSN=NA9999 , PO=R , F=SI , LB=KU,D=GE. 

A —  read  a  NOS/BE  unlabelled  tape 
at  6250  cpi 

LDSET  (Loader)  Set  option(s)  for  the  current  load. 

Syntax :  LDSET (optl,opt2,... ,optn) 

LDSET. 

Parameters:  opti  -  option  in  one  of  the  following  forms: 

key 

key=param 

key=paraml/param2/ . . . /paramn 
options  include: 

FILES, lfnl/lfn2/.. ./lfnn 
probably  not  needed 

LIB=1 ibl/1 ib2/. . ./libn 

LIBEDIT  libraries  to  be  searched 

MAP=p/ 1 f n 

p  -  one  or  more  of: 

N  -  no  map 

S  -  error  messages  and  loader 
statistics 

B  -  block  list  and  list  of 
unsatisfied  externals 
E  ~  entry  point  list  without 
cross  reference 
X  -  entry  point  list  with 
cross  reference 
(default:  SB) 

lfn  -  the  file  to  hold  the  map 
(default:  OUTPUT) 

PRESET=p 

PRESETA=p 

preset  memory  as  specified: 

p  octal  preset  value 


NONE  no  presetting 

ZERO  0000  0000  0000  0000  0000 

DEBUG  6000  0000  0004  0040  0000 

NGINF  4000  0000  0000  0000  0000 

ALTZERO  2525  2525  2525  2525  2525 

(alternating  0  and  1) 
n  a  1-20  digit  octal  constant 

with  optional  +,  -  and 
terminal  B 

(PRESETA  puts  each  location's  address 
in  the  17  low  order  bits) 

(default:  PRESET=ZERO) 
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LENGTH 


LGO 


Remarks:  MAP=S  provides  statistics:  program  length, 

routines  present  and  missing. 

LDSET  without  parameters  will  prompt  you  for  them. 
See  also:  page  5-6-5 

Similar  commands:  COS:  SEGLDR, PRESET= 

NOS/VE,  VMS:  virtual  memory 

Examp 1 es :  LDSET , PRESETA=DEBUG , MAP=S . 


/LDSET 

LDR>?  LDSET, MAP= S , PRESETA= DEBUG. 

LDR>?  LDSET, LIB=DTLIB .  < —  previously  attached 

LDR>?  LOAD, LGO. 

LDR>?  NOGO,ABS.  < —  create  absolute 

/ABS.  < —  execute 


Gives  the  current  status  of 

Syntax:  LENGTH, lfn. 

Remarks:  The  information 

current  status. 

See  also:  ENQUIRE, FN=lfn. 

Similar  commands:  COS:  DS 

Examples:  LENGTH, raylfn. 


one  of  your  local  files. 


includes  is  length  (PRUS) , 


type. 


(Loader)  Load  and  execute  the  default  compiler  binary  output 
file. 


Syntax:  LGO. 

LGO , p 1 i s  t . 


Parameters:  plist 


list  of  positional  and/or  keyword 
parameters  for  the  program  being  executed 


See  also:  name 


Similar  commands:  COS:  name 

NOS/VE:  LGO 

Examples:  FTN5. 

LGO. 
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LIBEPIT  Create  and  maintain  a  library  of  programs,  subprograms, 
procedures,  or  text. 

Syntax:  LIBEDIT,P=lfn,N=lfn, I=lfn,Z,B=lfn,L=lfn, 

L0=options, V,C,D,U=record,NA,NI,NR,NX=n. 

Parameters:  P=  -  the  old  file 

P=0  =>  create  new  file  from  replacement 
files 

N=  -  the  new  file 

1=  -  input  directive  file 

1=0  =>  no  directives 

Z  -  directives  immediately  follow  the  command 
terminator  (the  first  character  after  the 
terminator  is  the  directive  separator; 
overrides  1=) 

B=  -  replacement  and  insertion  records 
B=0  =>  no  replacement  file 

L  -  summary  of  LIBEDIT  run  and  any  requested 
listings 

L=0  =>  suppress  output 

LO=  -  list  options 

option  meaning 

C  list  directives 

E  list  errrors 

M  list  modifications 

N  list  records  written  to  new  file 

F  full  listing  (same  as  LO=CEMN) 

V  -  verify  new  file  against  old  file  by  calling 
VFYLIB  (U  overrides  V) 

C  “  copy  new  file  over  old  file  when  done 

D  -  do  not  abort  on  processing  errors 

U=  -  old  file  is  required  to  be  a  user  library; 
new  file  is  made  a  user  library  by  call  to 
LIBGEN  (overrides  V)  -  the  value  <record> 
becomes  the  name  of  the  user  library 
directory  record 
U  or  omitted  -  same  as  U=UL1B 

NA  -  do  not  abort  on  directive  errors 

NI  -  do  not  insert  unreplaceabl e  records  at  EOF 
of  new  file 
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• 

NR  -  old  and  new  files  not  rewound  before  or 
after 

NX=  -  n=0  -  include  cross  references  in  library 

directory  of  new  user  library 
n<>0  -  do  not  include  cross  references 
(has  meaning  only  for  U  or  the  *LIBGEN 
directive) 

Directives : 

See  Section  5-5. 

Defaults : 

interactive:  LIBEDIT,P=OLD,N=NEW, 1= INPUT, B=LGO, 

L=OUTPUT,LO=EM,NX=0. 

all  others:  LIBEDIT, P=0LD,N=NEW, I=INPUT, B=LGO, 

L=OUTPUT,LO=F,NX=0. 

Remarks : 

Either  parameter  U  or  the  *LIBGEN  directive  is 
required  to  make  your  new  library  a  user  library. 

If  the  output  is  to  tape  and  the  tape  may  be 
processed  at  a  later  date  by  GTR  or  MODIFY, 
put  the  new  file  on  disk  and  COPY  it  to  tape. 

This  will  insure  that  the  directories  have  disk 

PRU  random  addresses  and  not  tape  PRU  random 
addresses . 

See 

LIBGEN 

Similar  commands:  COS:  BUILD 

NOS/VE:  CREATE  OBJECT  LIBRARY 

VMS:  LIBRARIAN 

Examples : 

LIBEDIT , P=mysubs ,N=myl ib . 

LIBGEN  Create  a  new 

user  library  of  routines  for  use  by  tne  loader. 

Syntax : 

LIBGEN , F= 1 f n , P= 1 f n , N=name , NX=n . 

Parameters : 

F^  -  source  file  containing  absolute  (ABS) , 

overlay  (OVL) ,  procedure  (PROC) ,  relocatable 
(REL) ,  or  capsule  (CAP)  records 
(no  library  generated  if  none  of  these 
records  is  in  F) 

(default:  F=LG0) 

P=  -  will  contain  the  new  user  library 
(default:  P=ULIB) 

• 

N=  -  name  of  the  generated  user  library;  entered 
in  ULIB  and  OPLD  records 
(default:  N=value  of  P) 

Page  1-72 


RevO 


90/09/30 


LIBLOAD 


LIBRARY 


NX=  -  n=0  ~  include  cross  references  in  library 

directory  of  new  user  library 
n<>0  -  do  not  include  cross  references 
(default:  NX=0) 


See  also:  LIBEDIT 

Similar  commands:  COS:  BUILD 

NOS/VE:  CREATE_OBJECT_LIBRARY 
VMS:  LIBRARIAN 

Examples:  ATTACH, subs. 

FTN5 , I=subs . 

LIBGEN, P=myl ib . 


(Loader)  Load  modules  from  a  library  which  contain  the 

specified  entry  points. 

Syntax:  LIBLOAD, 1 ibname , eptnamel , eptname2 , . . . , eptnamen. 

Parameters:  libname  -  the  library  containing  the  desired 

entry  points 

eptnamei  ~  a  specific  entry  point  to  be  loaded 
(only  one  entry  point  for  core  image 
load) 

See  also:  LOAD 

Similar  commands:  VMS:  LINK  . . . , 1 ibrary/LIB/INCLUDE= 

Examples:  LIBGEN, F=LG0, P=mysubs . 


(Loader)  Specify  a  set  of  global  libraries  to  be  searched  for 
externals  and  programs  and  the  order  in  which  they  are  to  be 
considered. 


Syntax :  LIBRARY , filel,file2,...,filen/directive. 


Parameters:  filei  -  system  or  user  library 

(a  maximum  of  2  user  libraries) 


directive  -  specify  if  the  files  are  to  be  added 
to,  deleted  from,  or  replace  your 
global  library  set. 
directive  meaning 


A  add 

D  delete 

R  replace 

(default:  R) 


Omit  all  parameters  to  clear  your  global  library 
set . 
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Remarks:  The  order  of  search  for  externals  is: 

global  (those  on  most  recent  LIBRARY) 
local  (those  in  LDSET,LIB=  or  in  LDSET  tables 
in  the  loaded  modules) 
system  (SYSLIB) 

The  order  of  search  for  programs  is: 

local  files;  global,  local  and  system  (NUCLEUS) 
libraries 

LIBRARY  may  not  occur  in  a  load  sequence. 

A  no-auto-drop  status  is  set  for  these  files 

while  they  are  in  the  global  set.  See  SETFS. 

Similar  commands:  COS:  LIBRARY 

NOS/VE:  CHANGE_COMMAND_SEARCH_MODE ; 

CREATE_COMMAND_LIST_ENTRY 
VMS:  LINK  . . . , library/LIB 

Examples:  LIBRARY, MYLIB.  < —  global  set  has  MYLIB 

LIBRARY, YOURLIB/A.  <—  global  set  has  MYLIB 

and  YOURLIB 

LIBRARY.  < —  global  set  empty 


LIMITS  List  your  validation  limits. 

Syntax:  LIMITS, L=lfn. 

Examples:  LIMITS. 


LINE  (IAF)  Set  your  terminal  for  line  mode. 

Syntax:  LINE. 

LINE, TM=model . 

LINE, model . 

Parameters:  See  SCREEN. 

Remarks:  LINE  may  be  included  in  a  procedure. 

LINE  is  the  default  setting  unless  SCREEN  is 
included  in  your  l.OGINPR  file. 

Affects  FSE,  HELPME,  screen  formatting,  and  the 
display  of  NOS  procedure  parameters. 

See  also:  SCREEN 

Similar  commands:  NOS/VE:  CHANGE  INTERACTION  STYLE 


Examples : 


LINE. 
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LIST  (IAF)  List  lines  of  a  local  file. 

Syntax:  LIST,F=lfn 

Parameters:  F=  -  the  local  file  to  be  listed 

(default:  the  primary  file) 

Similar  commands:  VMS:  VSYS:LISTN  (DTRC) ;  TYPE 

Examples:  LIST, F=MYFILE 

A—  list  local  file  MYFILE 


LISTLB  List  labels  of  an  ANSI-labelled  multi-file  tape. 

Syntax :  LISTLB, 1 fn, SI=set id,QN=seqno , LO=l type , L=out . 

Parameters:  SI=  -  1-  to  6-character  file  set  identifier 

QN=  -  1-  to  4-character  file  sequence  identifier 

L0=  -  label  type(s)  to  be  listed 
A  -  all  labels 
R  -  required  labels 
0  -  optional  labels 
V  -  VOLn  labels 
H  -  HDRn  labels 
F  -  EOFn  labels 
E  -  EOVn  labels 
U  -  uvln,  uhln,  utln  labels 
(default:  A) 

Examples :  LABEL, tape , SI=NA9876. . . . 

LISTLB, tape, SI=NA9876. 


LISTLID  List  network  configuration  and  host  availability  information. 
Syntax : 


Parameters : 


LISTLID, LID=1 id, PID=pid,L=lfn. 
LISTLID, ST=1 id, PID=pid, L=lfn. 

LID=  -  a  specific  logical  identifier 
ST= 


PID“  -  a  specific  physical  identifier 
Similar  commands:  VMS:  SHOW  NETWORK 


Examples : 


LISTLID. 
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LOAD  (Loader)  List  of  object  files  whose  contents  are  to  be  loaded. 
Syntax:  LOAD, lfnl , lfn2, 1 fnn. 

Parameters:  Ifni  -  rewind  (except  INPUT)  before  loading 

lfni/R  -  rewind  before  loading 
lfni/NR  -  do  not  rewind  before  loading 


See  also: 

LIBLOAD,  SLOAD 

Similar  commands:  COS:  SEGLDR  BIN=dnl,dn2 

VMS:  LINK  f 1 , f 2 , . . . 

*  •  •  • 

Examples : 

LOAD, LGO, BIN. 

Prevent  writi 

ng  on  a  file. 

Syntax : 

LOCK, lfnl, lfn2, . . . ,lfnn. 

Parameters : 

Ifni  -  a  local  file 

Remarks : 

Used  to  prevent  writing  on  a 

local  file. 

See  also: 

UNLOCK 

Similar  commands:  COS: 

VMS:  OPEN (... .READONLY) 
program 

in  Fortran 

Examples : 

. . .  < —  create  a  new 

LOCK, newf i le . 

file 

* —  inhibit  further  writing  on  file 
NEWFILE 

. . .  < —  other  commands 

UNLOCK, newfile. 

A--  all  writing  on  file  NEWFILE 

LOGIN  (IAF)  Terminate  your  current  application  and  start  another. 
Syntax:  LOGIN, appl icati on 

Remarks:  LOGIN  may  be  used  in  a  procedure  or  batch  job, 

where  it  terminates  the  job. 

See  also:  HELLO;  LOGOUT,  BYE,  GOODBYE 

Similar  commands:  NOS/VE:  LOGIN 

Examples:  LOGIN, ICF  < —  switch  to  ICF 
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LOGOUT 


L072 


(IAF)  Terminate  an  application. 


Syntax:  LOGOUT, application 

Remarks:  LOGOUT  may  be  used  in  a  procedure  or  batch  job, 

where  it  terminates  the  job. 


See  also:  BYE,  GOODBYE;  LOGIN,  HELLO 


Similar  commands:  COS:  AZ,QUIT 

NOS/VE,  VMS:  LOGOUT 


Examples:  LOGOUT 


Reformat  files. 


Syntax:  L072,pl,p2, . . . ,pn. 


Parameters:  I=lfn 

I 

1=0 

omitted 


file  with  reformat  parameters 
same  as  I=INPUT 

no  file  of  reformat  parameters 
same  as  1=0 


S=lfn 

S 

omitted 

L-lfn 

L 

omitted 

T=x 


T 

omitted 

H=xxx 

H 

omi tted 


LP 

NR 


input  file  to  be  reformatted 
same  as  S=SCR 
same  as  S=SCR 

output  reformatted  file 
same  as  L=OUTPUT 
same  as  L=0UTPUT 

type  of  file  being  reformatted 
x  meaning 


M  Modify  source  data 
C  COMPASS  source  data 
B  other  source  data 
same  as  T=B 
same  as  T=B 

(truncation)  length  of  output  line 
same  as  H=72 
same  as  H=72 

(max:  150;  must  be  >=  Nx+Ox) 

(see  Remarks  below) 

format  for  line  printer 

do  not  rewind  S  file 


Nx=y  -  number  of  characters  to  be  moved 
x  -  field  number  (1_6) 
y  -  number  of  characters  being  moved 
(see  Remarks  below) 
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Ix=y  -  input  data  field 

x  -  field  number  ( 1—6) 
y  -  starting  column 
(see  Remarks  below) 

Ox=y  -  output  data  field 

x  -  field  number  ( 1—6) 
y  ~  starting  column 
(see  Remarks  below) 

IT  -  suppress  query  before  each  change 

omitted  -  query  before  each  change 
(interactive  jobs  only) 

Remarks:  Restrictions  on  H,  N,  I,  0: 

(Nx+Ix)>150  — >  error  for  l<=x<=6 
(Nx+Ox) >H  — >  error  for  l<=x<=6 
H  >150  — >  error 

Defaults  for  N,  0,  I: 


type 

Nl 

11 

01 

N2 

12 

02 

N3 

13 

03 

B 

72 

1 

1 

0 

0 

0 

0 

0 

0 

C 

7 

9 

1 

50 

41 

8 

15 

112 

58 

M 

2 

6 

1 

48 

10 

3 

22 

82 

51 

Ni  ,  I  i 

,0i=0 

for 

4<= 

i<=6 . 

Most  useful  in  compressing  compiler  list  output 
to  fit  into  72  columns 

Similar  commands:  VMS:  VSYS:CPYEXT  (DTRC) 

Examples :  L072 , S=myi n, L=myout ,11=2,01=1. 

A —  restore  a  file  that  was  shifted 
one  column  to  the  right,  perhaps 
by  C0PYSBF 

MAP  (Loader)  Specify  the  global  default  option  for  load  maps. 

Syntax:  MAP. 

MAP , p . 

Parameters:  p  -  the  desired  load  map 


P 

meaning 

OFF 

no  map 

(same  as  LDSET,MAP=N) 

PART 

statistics  and  block  map 
(same  as  LDSET,MAP=SB) 

ON 

PART  plus  entry  point  cross- 
reference 

(same  as  LDSET,MAP=SBX) 

FULL 

ON  plus  entry  point  map 
(same  as  LDSET , MAP=SBEX) 

(default 

at  DTRC:  OFF) 
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Remarks : 


MAP  without  a  parameter  resets  to  the  default. 


MAP  remains  in  effect  until  changed  by  another 
MAP  statement.  It  may  be  overridden  for  the 
next  load  by  using  LDSET,MAP=. 


The  more  map  requested,  the  more  CP  time  and 
memory  is  required  to  generate  it. 

See  also:  LDSET 


Similar  commands:  COS:  SEGLDR 

VMS:  LINK  qualifiers 

Examples:  MAP (PART) 


Merge  files. 


Syntax : 


FILE , 1 fninl , . . . . 
FILE, lfnin2, . . .  . 


FILE , 1 fnout , 
MERGE. pl,p2, 
or 

MERGE.pl  p2 
Positional : 


,pn 


pn 


MERGE. from, to,key,dir,l,,e,el, 
dialog, end, , , ownf , ownf 1 , 
ownmr 1 , , ownl , own 2 , own3 , 
own4, own5 , retain, seqa,seqn, 
seqr , seqs , s  tat us , sum, , 
verify, fastio. 


Interactive:  MERGE. DIAL0G= YES 


Directive  file:  MERGE. DIR=lfn 

MERGE. pa rams , DIR=1 fn 
MERGE. DIR=lfn, par ams 
MERGE. pa rams , DIR=1 f n , . . 
.more_params 


Parameters:  See  SORT5. 


VERIFY  -  Verify  that  each  input  file  is  sorted 
before  merging  them. 

Remarks:  Files  to  be  merged  must  be  presorted. 

See  S0RT5  remarks. 

See  also:  S0RT5 


Similar  commands:  COS,  VMS:  SORT 

NOS/VE*  MERGE 
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MFL 


MODE 


MODIFY 


name 


Examples :  FILE, ini , BT=C, RT=Z , MRL=8C. 

FILE, in2,BT=C,RT=Z,MRL=80. 

FILE, out fyl,BT=C,RT=Z,MRL=640. 
MERGE.  (inl,in2) ,outfyl 

A —  merge  two  files 
MERGE. FR0M= (ini, in2) ,TO=outfyl 
A —  same 


Reset  maximum  field  length  for  subsequent  job  steps. 


Syntax:  MFL,CM=nnnnnn. 

MFL,nnnnnn. 

Remarks:  MFL  clears  RFL  and  allows  the  system  to  determine 

the  FL  for  each  job  step. 

MFL  cannot  exceed  the  job  statement  CM  or  376500 
octal,  whichever  is  lower. 


See  also:  RFL. 


Examples:  MFL, 200000. 


Mode  error  bypass  should  not  be  used  at  DTRC.  An  attempt  to 
ignore  Error  Mode  1  may  cause  an  Error  Mode  0. 

Edit  a  Modi fy-f ormatted  program  library. 

Remarks:  Use  UPDATE. 


(Loader)  Load  and  execute  binary  program  or  procedure  in  local 

file  "name". 

Syntax:  name. 

name , pi ist . 

Parameters:  plist  -  list  of  positional  and/or  keyword 

parameters  for  the  program  or  procedure 
being  executed 

See  also:  BEGIN,  LGO 

Similar  commands:  NOS/VE,  COS:  name 

VMS:  RUN;  logical  name 

Examples:  ATTACH, myprog. 

myprog. 
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NEWCHRG 


NEWRTNS 


NEWS 


(DTRC)  Set  the  current  charge  number  of  some  or  all  files. 
Syntax:  BEGIN , NEWCHRG, , fn . 

Parameters:  fn  -  optional  filename  (wildcards  allowed) 

(default:  all  files) 


Remarks:  Useful  at  the  start  of  the  Fiscal  Year  or  any 

other  time  you  have  to  change  a  lot  of  files. 

See  also:  CHANGE 

Similar  commands:  COS:  NEWCHRG 


Examples:  BEGIN, NEWCHRG. 

A —  change  all  files 

BEGIN , NEWCHRG , , a****** . 

A —  change  all  files  starting  with 
an  "A" 


(DTRC)  Display  a  brief  description  of  new  routines  added  at 
DTRC. 


Syntax: 


BEGIN , NEWRTNS , , OUTPUT . 


Parameters:  OUTPUT  -  output  fils 

(default:  OUTPUT) 


See  also: 


NEWS,  OLDNEWS 


Similar  commands:  NOS/VE:  NEW_ROUTINES 

VMS:  NEWROUTINES 


Examples:  BEGIN , NEWRTNS . 

A —  display  on  your  terminal 

BEGIN , NEWRTNS , , myout . 

A—  put  into  file  MYOUT 


(DTRC)  Display  the  current  news  items. 

Syntax:  BEGIN, NEWS, .OUTPUT. 

Parameters:  OUTPUT  -  output  file 

(default:  OUTPUT) 

See  also:  OLDNEWS,  NEWRTNS 

Similar  commands:  NOS/VE,  VMS:  NEWS 

Examples:  b£biN,NEWS. 

A —  display  on 


your  terminal 
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BEGIN, NEWS, ,myout . 

put  into  file  MYOUT 

NOEXIT  Continue  processing  with  the  next  command  even  if  an  error  has 
occurred  (suppress  EXIT  processing). 

Syntax:  NOEXIT. 

See  also:  EXIT,  ONEXIT 

Similar  commands:  VMS:  ON  condition 

Examples:  NOEXIT.  < —  Exit  processing  off 

FTN5 . 

01iEXrT.  < —  restore  exit  processing 

LGO.  < —  executed  even  if  compile  errors 

...  < —  not  executed  if  execution  errors 

NOGO  (Loader)  Complete  loading  of  a  program,  generate  load  map  (if 

requested),  put  absolute  into  a  file  (if  requested),  but  do 
not  execute. 

Syntax:  NOGO. 

NOGO, abs . 

Parameters:  abs  -  will  contain  the  loaded  program  as  a  single 

core  image  module  (non-segmented/non- 
overlay  loads  only) 

(<abs>  is  suitable  for  inclusion  in  a 
LIBEDIT  library) 

See  also:  LDSET 

Similar  commands:  COS:  SEGLDR  (ABS=  directive) 

VMS:  LINK 

Examples:  DEFINE, myprog/NA. 

LOAD, LGO. 

NOGO,myprog. 

NORERUN  Clear  the  job  rerun  status. 

Syntax:  NORERUN. 

Remarks:  May  be  useful  to  prevent  updating  a  file  when  the 

job  would  ordinarily  be  rerun. 

Sc-,  air''!  RERUN 

Similar  commands:  COS:  RERUN 


Examples : 


NORERUN. 
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NORMAL 


NOTE 


(IAF)  Reverse  the  effect  of  ASCII,  AUTO,  BRIEF,  CSET, ASCII, 
and  NOSORT  commands. 


Syntax : 
See  also: 
Examples: 


NORMAL 

ASCII,  AUTO, BRIEF,  CSET,  NOSORT 
NORMAL 


Create  a  file  with  the  command  line  containing  the  lines  for 
the  new  file. 

Syntax :  N0TE,lfn,NR./line_l/line_2/.../l ine_n 

Parameters:  lfn  -  (default:  OUTPUT) 

NR  -  Do  not  rewind  lfn  before  and  after 
(default:  rewind) 

/  -  a  delimiter  (any  character)  denoting  the 

start  of  a  new  line  for  the  file 
(the  character  immediately  following  the 
terminator  is  the  delimiter) 

line_i  -  the  contents  of  the  i~th  line  of  the 
new  file 

Similar  commands:  COS:  NOTE 

NOS/VE:  COLLECT_TEXT;  PUT_LINE 
VMS:  OPEN, WRITE, CLOSE 

Examples:  NOTE, DATA./  1  2 . 4/LINE  OF  TEXT/0. 1  1E-4/END 

* —  create  a  new  file  DATA 

Local  file  DATA  contains: 

1  2.4 

LINE  OF  TEXT 

0.1  IE-4 

END 


NOTE, DATA, NR./  1  2.4/LINE  OF  TEXT/0.1  1E-4/END 
NOTE, DATA, NR./  2  3.6/ANOTHER  LINE  OF  TEXT 
NOTE, DATA, NR. /0. 1  1E-4/END 

A —  create  file  with  many  lines 
PACK, DATA.  < —  remove  embedded  EORs 

Local  file  DATA  contains- 

1  2.4 

LINE  OF  TEXT 
0.1  IE-4 
EivD 

2  3.6 

ANOTHER  LINE  OF  TEXT 

0.1  IE-4 

END 
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NOTE, UIN. /*compi le  prog  1 , sub 1 , sub2 
UPDATE, I=UIN. 

NOTE, , NR. /THE  PROGRAM  FINISHED 

A —  useful  for  displaying  messages 
(comments)  from  a  procedure 

NULL  (IAF)  Select  the  NULL  subsystem. 

Syntax:  NULL 

Remarks:  This  is  the  default  subsystem  in  a  batch  job. 

RUN  will  not  work  in  the  NULL  subsystem. 
Examples:  NULL 


OFFSW  Clear  sense  switches. 

Syntax :  OFFSW, swi tch_l , swi tch_2, . . . , swi tch_n, j  sn. 

Parameters:  switch_i  -  a  sense  switch  to  be  cleared  ( 1— 6) 

0  -  clear  all  sense  switches 

j  sn  -  since  a  jsn  is  recognized  by  its 

alphabetic  characters,  jsn  may  appear 
anywhere  in  the  parameters  list 

See  also:  ONSW 

Similar  commands:  COS:  SWITCH 

Examples:  OFFSW, 0,ABCD. 

A —  clear  all  sense  switches  for  job 
ABCD 


OFLREQ  (DTRC)  Generate  an  Off-Line  Request  to  process  tapes  for  the 
Calcomp,  Xerox  or  Microfiche. 


Syntax: 

BEGIN, OFLREQ, .type. 

Parameters : 

type  -  type  of  request 

936  -  Calcomp  936  plots 

1051  -  Calcomp  1051  plots 

CALCOMP  -  same  as  936 

CUM  -  microfiche 

FICHE  -  same  as  COM 

XEROX  -  Xerox  8700 

Remarks : 

This  is  for  use  with  Calcomp  output  and  for 
microfiche  and  Xerox  output  which  cannot  be 
handled  by  the  standard  BEGIN, FICHE  and 
BEGIN, XEROX. 
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The  procedure  will  execute  a  program  which  will 
prompt  you  for  the  information  needed  to  prepare 
the  Off-Line  Request.  When  complete,  the  Request 
will  be  printed  at  Central  Site  for  the  Off-Line 
operator.  A  copy  will  be  put  into  your  local 
file  FORM. 

When  running  OFLREQ  in  a  batch  job,  the  data  must 
be  in  local  file  KEYBRO.  Any  messages  from  the 
program  will  be  in  file  CONSOL. 

See  also:  BEGIN, FICHE,  BEGIN, XEROX 

Examples:  BEGIN, OFLREQ, , 1051 . 


OLDNEWS  (DTRC)  Display  the  old  news  items. 

Syntax :  BEGIN , OLDNEWS , , OUTPUT . 

Parameters:  OUTPUT  -  output  file 

(default:  OUTPUT) 

See  also:  NEWS,  NEWRTNS 

Similar  commands:  NOS/VE:  0LD_NEWS 

VMS:  OLDNEWS 

Examples:  BEGIN, OLDNEWS. 

A —  display  on  your  terminal 

BEGIN, OLDNEWS, ,myout. 

A —  put  into  file  MYOUT 


ONEXIT  Reverse  the  effect  of  NOEXIT. 

Syntax:  ONEXIT. 

See  also:  EXIT,  NOEXIT 

Similar  commands:  VMS:  NOON;  ON  condition  THEN  CONTINUE 
Examples:  See  NOEXIT. 


ONSW  Set  sense  switches. 

Syntax:  ONSW , swi tch_l , swi t ch_2 , . . . , swi tch_n , j  sn. 

Parameters:  switch_i  -  a  sense  switch  to  be  set  ( 1 — 6) 

0  -  set  all  sense  switches 

j sn  -  since  a  jsn  is  recognized  by  its 

alphabetic  characters,  jsn  may  appear 
anywhere  in  the  parameters  list 
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OPLEDIT 


OUT 


OVWRITE 


See  also:  OFFSW,  SWITCH 

Similar  commands:  COS:  SWITCH 

Examples:  ONSW, ABCD, 4 , 5 . 

A —  turn  sense  switches  4  and  5  on 
in  job  ABCD 

Remove  modification  decks  and  identifiers  from  a  MODIFY 
1 ibrary . 

Remarks:  Use  UPDATE  instead  of  MODIFY. 


Send  deferred  output  files  to  the  print  or  punch  queue 
immediately. 


Syntax:  OUT.  < —  queue  all  files 

OUT, *, lfnl , 1 fn2 ,..., 1 fnn.  < —  queue  all  files, 

except  those  listed 

Remarks:  OUT  processes  any  file  given  deferred  ROUTE-ing 

as  well  as  OUTPUT,  PUNCH,  PUNCHB,  P8. 


See  also:  ROUTE 


Similar  commands:  COS:  DISPOSE 


Examples:  OUT. 


Overwrite  files  to  erase  (destroy)  their  contents. 

Syntax:  OVWRITE, lfnl , lfn2, . . . , lfnn/0P=plp2. 

A —  overwrite  specified  files 

OVWRITE, *, lfnl , lfn2 , . . . , 1 fnn/OP=p lp2 . 

A —  overwrite  all  but  specified 
files 

Parameters:  OP=  -  how  files  are  to  be  overwritten  and 

whether  they  are  to  be  released 
pi  meaning 

Z  overwrite  with  zeros 

X  overwrite  with  zeros,  then  ones, 

then  alternating  zeros  and  ones 
R  release  files  after  overwriting 

(default:  0P=Z) 
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Similar  commands:  COS:  SCRUBDS;  WRITEDS 

Examples:  OVWRITE, fyl 1 ,OP=XR. 

* —  clear  a  file,  then  release  it 


PACK 


Combine  all 
EOFs . 

Syntax : 

Parameters : 


Remarks : 
Examples : 


records/files  in  a  file  by  removing  all  EORs  and 

PACK, lfn_in, lfn_out ,x. 

lfn_in  -  (not  rewound  after) 

lfn_out  -  (default:  lfnout=lfnin; 

rewound  after,  but  not  before) 

x  -  non-null  to  not  rewind  lfn_in  before 

packing 

Do  not  use  with  S,  L,  or  F  tapes. 

PACK, infyl , pkdfyl . 


PASSWOR  Change  your  password. 


Syntax:  PASSWOR , oldpw, newpw  . 

PASSWOR. 


Parameters:  oldpw  -  old  password 

newpw  -  new  password  (4-7  alphanumeric  characters 

with  at  least  one  digit) 

Remarks:  At  DTRC,  there  is  only  one  password  for  both 

batch  and  interactive. 

Similar  commands:  COS:  ACCOUNT, NUPW=nupw, ... ; 

CNEWPW;  CSUBMIT/NUPW  (from  VMS) 
(DTRC) 

NOS/VE:  CHANGE_LOGIN_PASSWORD;  SET_PASSWORD 
VMS:  SET  PASSWORD 


Examples:  PASSWOR, old, new. 


PAUSE  Set  the  pause  bit  of  one  of  your  executing  jobs. 
Syntax:  PAUSE, jsn. 

See  also:  GO 


Examples : 


PAUSE, ABCD. 
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PDU  (Panel  Definition  Utility)  Compile  a  panel  definition  and 

store  the  compiled  panel  in  a  user  library. 

Syntax :  PDU , I=panel , L=1 is t ing,C=capsule , LIE=1 ibrary . 

PDU , panel , listing, capsule, library. 

PDU?  < —  prompt  for  the  parameters 

Parameters:  panel  -  the  local  panel  definition  file 

(6/12  display  code;  must  be  same  as  the 
panel  name) 

listing  -  the  output  listing 
(default:  OUTPUT) 

L=0  -  inhibits  the  listing  with  the  message 

PANEL-CAN 'T  OPEN  FILE  0 

capsule  -  the  name  of  the  generated  capsule  file 
C=0  -  syntax  check  only 

library  -  the  name  of  the  (local)  panel  library 
(default:  PANELIB) 

LIB=0  -  do  not  change  a  library  file 

Remarks:  Panels  are  part  of  Screen  Formatting.  See  CDC 

publication:  60460430  ~  NOS  Version  2  Screen 
Formatting  Reference  Manual. 

See  also:  SHOW,  ULIB 

Similar  commands:  VMS:  FMS 

Examples:  In  local  file  TEST: 

{  PANEL  TEST  PRIMARY 
VAR  RSIDEl  T=REAL  F=E  R=(0.  999999999.) 

HELP='Enter  positive  integer  or  real  value' 
VAR  RSIDE2  T=REAL  F=E  R=(0.  999999999.) 

HELP='Enter  positive  integer  or  real  value' 
VAR  RSIDE3  T=REAL  F=E  R=(0.  999999999.) 

HELP='Enter  positive  integer  or  real  value' 
KEY  HELP=  (F5) 

KEY  NORMAL* (NEXT) 

KEY  ABNORMAL* (F6)  } 

To  find  the  area  of  a  triangle: 

Enter  values  for  Side  A:  _ 

Side  B: 


Side  C: 
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Press:  NEXT  to  continue 

F5  for  help 
F6  t o  qui t 

PDU,test.  <—  compile  the  panel  into  PANELIB 
SHOW, test.  < —  test  the  panel 

PERMIT  Explicitly  permit  another  user  to  access  one  of  your  private 
or  semi-private  files. 

Syntax :  PERMIT , pfn , un_l=m_l , un_2=m_2 , . . . , un_n=m_n/NA. 

Similar  commands:  COS:  permit  lists 

NOS/VE:  CREATE_CATALOG_PERMIT;  CREATE_FILE 
PERMIT;  DELETECATALOGPERMIT; 
DELETE_FILE_PERMIT 
VMS:  Access  Control  Lists 

Examples:  PERMIT ,myf i le , ABCD=R . 

A--  allow  ABCD  to  read  the  file 


PURGALL  Purge  all  your  files  which  match  the  parameters. 

Syntax:  F'JRGALL,  TY=ty, CT=ct ,  AD=ad,MD=md,CD=cd,  AF,  TM=tm,NA. 

Parameters:  ty  -  file  type 

ty  .  meaning 

I  (INDIR)  all  indirect  files 

D  (DIRECT)  all  direct  files 

A  (ALL)  all  files 

(Default:  TY=A,  if  any  other  parameter  is 

specified) 

ad  -  all  files  last  accessed  before  (after,  if  AF) 
this  date  (yymmdd) 

md  -  all  files  last  modified  before  (after,  if  AF) 
this  date  (yymmdd) 

cd  -  all  files  created  before  (after,  if  AF) 
this  date  (yymmdd) 

AF  -  all  files  after  AD,  MD,  or  CD  dates 

tm  -  time-of-day  on  the  AD,  MD,  CD  date  (hhmmss) 

Remarks:  AF,  CT,  DN,  MA,  TY,  TM,  and  one  date  (either  AC, 

MD,  CD)  fit  on  a  single  PURGALL  command. 

Similar  commands:  VMS:  DELETE;  PURGE 
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Examples:  PURGALL,AD=881001 . 

A —  purge  all  (your)  files  not 
accessed  in  2  or  more  years 
(assuming  today  is  October  1, 
1990) 


PURGE  Purge  one  or  more  direct  or  indirect  permanent  files. 

Syntax :  PURGE , pfn_l , pf n_2 , . . . , pfn_n/UN=un , PW=pw, NA. 

Remarks:  If  the  file  is  attached,  it  remains  as  a  local 

file  until  RETURNed  or  LOGOUT. 

Similar  commands:  COS:  DELETE 

NOS/VE:  DELETE_FILE;  DELETE_ALL_CYCLES 
'DTRC) 

VMS:  DELETE;  PURGE 

Examples:  PURGE, myobj /Na.  < —  be  sure  file  is  not  present 

DEFINE, myobj .  < —  before  creating  a  new  one 

PUTASC  (DTRC)  Convert  a  6/12-bit  Display  Code  file  to  8/12-bit  ASCII 
and  make  it.  a  permanent  indirect  or  direct  file. 

Syntax:  BEGIN, PUTASC, , I=lfn,FN=fn. 

Parameters:  1=  -  name  of  8/12— bit  ASCII  local  file 

FN=  -  name  for  the  permanent  (indirect  or  direct) 
8/12-bit  ASCII  file 

Remarks:  This  is  useful  in  sending  ASCII  files  to  the 

VAXcluster  to  be  retrieved  using  HFT  FETCH  /ASCII. 

An  attempt  is  made  to  SAVE  the  file  as  an  indirect 
file.  If  it  is  too  large  (greater  than  696  PRUS) , 
it  will  be  DEFINEd  as  a  direct  file. 

See  also:  GETASC 

Similar  commands:  VMS:  HFT  STORE  /ASCII 

Examples :  BEGIN, PUTASC , , myf i 1 e ,myf i 1 e . 

A —  local  file  MYFILE  will  be 

converted  from  6/12-bit  Display 
Code  to  8/12-bit  ASCII  and 
saved  as  an  indirect  or  direct 
file 
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QGET 


Assign  a  queued  file  to  your  job. 


Syntax :  QGET, JSN= j  sn , DC=q , UJN=ujn , FN=1 fn . 

QGET , j  sn, q , ujn, 1 f n. 

Parameters:  DC=q  -  the  queue  containing  the  file 


q 

raeaning 

PR 

print 

PU 

punch 

PL 

plot 

WT 

wait 

IN 

input 

(default:  WT) 


FN=lfn  -  the  local  file  name  to  be  given  to  the 
file 


Examples : 


SUBMIT, my job, TO. 
ENQUIRE, JSN. 
QGET, j  sn. 


-or-  CSUBMIT, _ 

< —  get  jsn  of  job 
< —  get  the  file  from  the 
wait  queue 


RATES  (DTRC)  Display  the  current  computer  rates. 

Syntax:  BEGIN, RATES, .OUTPUT. 

Parameters:  OUTPUT  -  output  file 

(default:  OUTPUT) 

Similar  commands:  NOS/VE:  RATES 

VMS:  HELP  RATES 

Examples:  BEGIN, RATES. 

A —  display  on  your  terminal 

BEGIN, RATES, ,myout . 

A  —  put  into  file  MYOUT 
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RECLAIM  Selectively  backup  and  reload  local  and  permanent  files. 

Syntax:  RECLAIM.pl ,p2,...,pn./dirl,optsl/dir2,opts2/... 

Parameters:  pi  -  parameter 

diri  -  directive 

opti  -  option 

Remarks:  No  REQUEST  is  needed  for  a  magnetic  tape. 

Dump  tapes  MUST  be  labelled. 

RECLAIM  tapes  are  compatible  with  PFDUMP  and 
PFLOAD. 

See  also:  See  NOS  2  Reference  Set  Volume  3:  System  Commands 

for  a  15-page  discussion  of  the  RECLAIM  utility. 

Similar  commands:  NOS/VE:  BACKUP_PERMANENT_FI LES ; 

DISPLAY_RESTORE_PERMANENT_FILES 
VMS :  BACKUP 

Examples :  RECLAIM, L=0UT . DB=0 , Z . /DUMP , TN=NA9876 , EI=NO. 

A —  simple  dump  of  all  files  to  tape 
without  a  database 

PURGALL, TY=A. 

A —  AFTER  you  are  sure  the  dump  is 
correct ! 

RECLAIM , DB=0 , Z . /LOAD , TN=NA9876 , PF=myf i 1 e . 

A —  Reload  a  file 


RECOv£R  (IAF)  Recover  a  detached  job  or  interrupted  terminal  session. 
Syntax:  RECOVER , JSN=j sn, OP=T 

RECOVER, jsn.T 
RECOVER 

Parameters:  jsn  -  job  sequence  number  of  the  detached  job 

T  -  abort  recovery  if  no  recoverable  files 
(else  start  a  recovery  dialog) 

Examples:  /RECOVER , ABCD 

REDO  (IAF)  Recall  a  previously  entered  command  to  modify  and 

re-execute  it  without  having  to  retype  the  entire  command. 

Syntax:  REDO, string/GO 

R , string/GO 
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REDUCE 


Parameters:  string  -  the  first  up_to_10  characters  or  the 

command  to  be  kEDOne  (a  blank  or 
terminator  in  string  ends  the  command) 
(default:  the  most  recent  command) 


GO  -  re-execute  without  modification 

(OLD:,  MOD:,  NEW:  prompts  are  suppressed) 


Edit  chars:  space 

# 

& 


j 

other 


leave  character  unchanged 
delete  character  any  shift  line  to  left 
replace  character  with  a  space 
insert  characters  before  the  marked 
character  (end  the  inserted  string  with  a 
//;  A  RETURN  displays  the  command  line  as 
edited  so  far) 

delete  to  the  end  of  Lne  line 
replaces  the  original  character 


Similar  commands:  NOS/VE,  VMS,  VMS  Cray  Station:  <UP  arrow> 


Examples:  /REDO 

OLD:  CATLIST, LO=F , FN=ABCDEFG 

MOD:  hi j ! 

NEW:  CATLIST, LO=F,FN=HIJ 


/REDO 

OLD:  CATLIST, LO=X, FN=ABCDEFG 

MOD:  f  hi j ! A 

NEW:  CATLIST, LO=F,FN=HIJ  <—  changes  so  far 

MOD:  AP 

NEW:  CATLIST, LO=FP,FN=HIJ 


(Loader)  Turn  the  reduce  flag  on  or  off. 

Syntax:  REDUCE.  < —  turn  reduce  flag  on 

REDUCE(-)  < —  turn  reduce  flag  off 


Remarks : 


See  also: 
Examples : 


When  on,  the  loader  determines  the  field  length 
assigned. 

When  off,  you  determine  the  field  length  with 
RFL  statements. 


RFL 


FTN5. 

LGO. 

RFL, 50000. 
REDUCE (-) 
LGO. 
REDUCE. 


< —  program  executes  in  the  FL  needed 


< —  program  executes  in  50000  words 
< —  next  load  executes  in  what  is 
needed 
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RENAME  Change  the  name  of  a  local  file. 

Syntax:  RENAME, nfnl=ofni ,nfn2=ofn2, . . . ,nfnn=ofnn. 

Parameters:  nfni  -  the  new  name 

ofni  -  the  existing  name 

Remarks:  Does  not  change  the  name  in  the  permanent  file 

directory. 

Similar  commands:  NOS/VE:  CHANGE_CATALOG_ENTRY 

VMS:  no  local  file  concept 

Examples:  RENAME, that=this . 

A —  change  local  file  name  THIS  to 
THAT 


REPLACE  Purge  an  indirect  file  and  replace  it  with  a  copy  of  a  local 
file;  save  a  copy  of  a  local  file  as  a  new  indirect  file. 

Syntax:  REPLACE, lfn_l=pfn_l , lfn_2=pfn_2, .... lfn_n=pfn_n/ 

UN=un, PW=pw,M=m,NA. 

Remarks:  If  the  file  already  exists,  the  catalog  type 

(CT=)  and  all  other  information  about  the  file  is 
preserved;  if  it  does  not,  a  new  file  is  created 
with  CT=PRIVATE. 


See  also:  SAVE;  DEFINE 


Similar  commands:  NOS/VE:  C0PY_FILE;  CREATE_FILE 


— 

— 

Examples : 

REPLACE , myl f n=mypr og 

A —  replaces 
with  the 
MYLFN 

indirect 

contents 

file  MYPROG 
of  local  file 

REQUEST  Request  a  tape  be  mounted. 


Remarks : 


Use  LABEL. 
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REQUEST  Assign  a  file  to  receive  checkpoint  dumps,  or  send  a  message 
to  the  operator. 

Syntax:  REQUEST, lfn, ckpt . comment 

REQUEST, NE.message_to_oper a tor 

Parameters:  ckpt  -  lfn  is  to  be  a  checkpoint  file 

ckpt  meaning 


CK  put  each  dump  at  end  of  lfn 

CB  put  each  dump  at  beginning  of  lfn 

comment  -  message  to  the  operator  about  device 
assignment 

Similar  commands:  NOS/VE:  REQUEST_MAGNETIC_TAPE 

Examples:  REQUEST, NE. message 

A —  <message>  is  displayed  at  the 
operator's  console 


REQUEST, lfn, CK. 

A —  save  all  checkpoints 

REQUEST, lfn, CB. 

A —  save  the  last  checkpoint 

REQUEST, lfnl, CB. 

REQUEST, If n2,CB. 

A —  save  consecutive  checkpoints  by 
alternating  two  checkpoint 
files . 

DEFINE, lfn. 

REQUEST, lfn, CK.  -or-  ASSIGN 
CKP. 

A —  make  checkpoint  file  permanent 

RERUN  Allow  a  job  to  be  rerun  if  necessary. 

Syntax:  RERUN. 

Remarks:  A  job  is  normally  rerunable  unless  it  does 

something  which  might  make  a  rerun  fail,  such  as 

creating,  modifying  or  deleting  a  file,  etc. 

See  also:  NORERUN 

Similar  commands:  COS:  RERUN 


Examples : 


RERUN. 
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RESOURC  Specify  that  more  than  one  tape  drive  is  required. 

Syntax:  RESOURC ,rtl=ul,rt2=u2, . . . ,rtn=un 

Parameters:  rti  -  resource  type 

LO  -  7-track  tape,  200  cpi 
HI  -  7-track  tape,  556  cpi 
HY  -  7-track  tape,  800  cpi 
HD  -  9-track  tape,  800  cpi 
PE  -  9-track  tape,  1600  cpi 
GE  -  9-track  tape,  6250  cpi 

ui  -  maximum  number  of  units  this  job  will 

use  concurrently 

0  -  clear  a  resource  type  that  is  no 
longer  required 

2  -  maximum  at  DTRC  (LO,  HI,  HY,  HD) 

3  -  maximum  at  DTRC  (PE,  GE) 

Remarks:  Jobs  needing  only  a  single  9-track  tape  drive  at 

a  time,  even  for  a  multi-reel  file,  do  not  need  a 
RESOURC  statement. 

RESOURC  should  precede  the  first  tape  request. 
Subsequent  RESOURC  statements  may  change  any 
RT-U . 

This  statement  helps  prevent  deadlock. 

Similar  commands:  NOS/VE:  RESERVE_RESOURCES 

VMS :  ALLOCATE 

Examples:  RESOURC, GE=:2.  < —  two  6250  cpi,  9-track  tapes 

are  required  at  once 


JOB123 . 

USER , . .  . . 

CHARGE, .... 

RESOURC, PE=2.  <--  2  1600~cpi  tapes  needed 

LABEL, Tl,D=PE,VSN=t ape  1. 

LABEL, T2,D=PE,VSN=tape2. 

RETURN, T1,T2. 

RESOURC, PE=1,GE=1.  <—  1  1600  and  1  6250 


RESTART  Restart  a  checkpointed  job. 

Syntax:  RESTART , 1 fn,nnnn, x_i . 

Parameters:  lfn  -  the  checkpoint  file 

(must  have  write  permission) 
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nnnn  -  number  of  the  checkpoint 

(Default:  1;  use  *  for  last  checkpoint) 

x_i  -  RI  -  do  not  restore  command  file  on  Ifn 
NA  -  do  not  abort  if  a  required  file  is 
not  available;  if  read  parity  while 
restoring  a  file  in  checkpoint  nnnn, 
use  checkpoint  nnnn-1 
FC  -  do  not  restore  files  Z2ZZZC0,  Cl,  C2, 
if  already  local 

Examples:  RESTART, ckpfyl , *. 

RETURN  Release  files  (and  file  space  depending  on  file  type)  assigned 
to  a  job. 

Syntax:  RETURN, lfnl, lfn2, lfnn.  < —  all  listed 

files 

RETURN, *, lfnl, lfn2, . .. ,lfnn.  <--  all  but  listed 

files 

Parameters:  Ifni  -  a  file  assigned  to  your  job 

See  also:  CLEAR,  EVICT,  UNLOAD 

Similar  commands:  COS:  RELEASE 

NOS/VE:  DETACH_FILE;  RELEASEJIESOURCES 
VMS:  CLOSE  it  in  a  program 

Examples :  RETURN, dt 1 ib , sublib , workl , out . 

REVERT  Return  from  a  procedure. 

Syntax:  REVERT, opt . com 

Parameters:  opt  -  revert  option 

opt  meaning 


ABORT  return  to  next  EXIT,  unless  NOEXIT 
(REVERT  appears  at  your  terminal 
and  in  the  job  dayfile) 

EX  return  to  calling  procedure  and 

execute  command  <com> 

(REVERT  appears  in  the  job  dayfile 
but  not  at  your  terminal) 

NOLIST  return  to  calling  procedure 

(REVERT  does  not  appear  at  your 
terminal  or  in  the  job  dayfile) 

com  -  for  opt  EX:  the  command  to  be  executed 

for  other  opt:  a  comment 
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REWIND 


RFL 


Remarks:  The  following  statements  are  supplied 

automatically  at  the  end  of  a  procedure  to  insure 
that  a  REVERT  is  present: 

$REVERT.CCL 
SEXIT.CCL 
SREVERT, ABORT. CCL 

Similar  commands:  COS:  RETURN 

NOS/VE,  VMS:  EXIT 

Examples:  .PROC,MYPROC. 

.*  the  body  of  your  procedure 
REVERT, NOLIST. 

EXIT. 

DMP, 30000. 

REVERT, ABORT. 


Position  files  at  beginning-of_information  (BOI)  . 

Syntax:  REWIND, lfnl , lfn2, ..., lfnn.  <--  all  listed 

files 

REWIND,*, lfnl, lfn2, ..., lfnn.  < —  all  but  listed 

files 


Parameters:  Ifni  -  .  file  assigned  to  your  job 

Similar  commands:  COS:  REWIND 

NOS/VE:  REWIND_FILE 

Examples:  REWIND, myfile. 


Set  field  length  for  the  next  program  execution. 


Syntax:  RFL,CM=nnnnnn. 

RFL,nnnnnn. 

Remarks:  nnnnnn  may  not  exceed  the  last  MFL  or  job 

statement  setting. 

See  also:  MFL,  REDUCE 

Examples:  FTN5. 

LG0. 

RFL, 50000. 

REDUCE (-) 

LGO. 

REDUCE. 
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ROUTE  Direct  the  disposition  of  an  indirect  file  and  define  its 
characteristics . 

Syntax:  ROUTE, lfn, parameters . 

Parameters:  DC=dc  -  disposition  code 

IN  -  input  queue  (ouput  to  central 

site  or  the  user  specified  by  UN) 
LP  -  any  printer 
PL  -  plot 
PR  -  same  as  LP 
PU  -  punch  coded 
P8  -  punch  80-column  binary 
SB  -  punch  system  binary 
SC  -  rescind  prior  routine  and  make 
the  file  type  local 
TO  -  input  queue  (output  to  wait 
queue) 

(default:  same  as  in  previous  ROUTE 

for  this  lfn;  if  none,  DC=SC, 
except  these  special  names: 


name 

DC 

OUTPUT 

PR 

PUNCH 

PU 

PUNCHB 

SB 

P8 

P8  ) 

DC  -  same  as  DC- SC 

DEF  -  defer  routing  until  end-of-job 

(default:  do  it  now; 
not  allowed  with  DC=IN,  NO,  TO) 

EC=ec  -  external  characteristics  for  print 
and  punch  files 
print : 

ec  meaning 


A6  ASCII  graphic  63/64-char  set 

A9  ASCII  graphic  95-char  set 

(lfn  must  be  7-bit  ASCII8) 

FC=fc  -  forms  code 

FC  -  use  standard  print  or  card  forms 

FID=ujn  -  NOS/BE  compatibility  (same  as  UJN=) 

REP=rep  -  number  of  extra  copies 

(default:  0  (only  1  copy  printed); 
maximum:  31  (37B)) 

TID=  -  see  UN 

UJN=ujn  -  user  job  name  for  the  file  (not  input) 
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UN=un  ~  user  name  of  the  receiving  remote  batch 
or  interactive  user 
UN  -  implicit  remote  routing 

Remarks:  In  general,  if  a  parameter  is  omitted,  it 

retains  the  definition  from  the  last  ROUTE 
command  which  referenced  that  "lfn".  The 
exception  is  DEF. 

Similar  commands:  COS:  DISPOSE 

NOS/VE:  PRINT_FILE;  SUBMIT_JOB 
VMS:  SUBMIT;  PRINT;  XEROX  (DTRC) ; 

FICHE  (DTRC) 


Examples:  CATLIST, LO=F, L-outl . 

ROUTE, out  1 ,DC=PR.  < —  print  at  Central  Site 


ROUTE,mydata,DC=PU,UJN=xxxxx . 

A —  punch  deck  with  banner 
card  of  "xxxxx" 


RTIME  Put  the  real-time  clock  time  into  the  dayfile. 
Syntax:  RTIME. 

See  also:  CTIME,  STIME 

Similar  commands:  VMS:  AT 
Examples:  RTIME. 


SATISFY  (Loader)  Satisfy  unsatisfied  externals  now,  instead  of  at  the 
end  of  the  loading. 


Syntax:  SATISFY. 

SATISFY, libl, lib2, . . . , libn. 

Parameters:  libi  -  a  specific  library  to  be  searched  in  the 

listed  order 

(default:  all  known  libraries  are  searched) 


Examples:  LOAD,binl. 

SATISFY (mylib) 
LOAD, bin2 . 
SATISFY. 
bin3. 
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SAVE 


SCOPY 


Put  a  copy  of  a  local  file  on  disk  as  an  indirect  file. 

Syntax:  SAVE, lfn_l=pfn_l , 1 fn_2^pfn_2, . . . , lfn_n=pfn_n 

/PW=pw, CT=ct , M=m, SS=ss , BR=br , PR=pr ,NA, AC=ac . 


See  also:  REPLACE;  DEFINE 

Similar  commands:  NOS/VE:  COPY__FILE;  CREATE_FILE 

Examples :  SAVE,mytemp=keepi t/CT=PU. 

A —  save  local  file  MYTEMP  as  a 
public  file  unless  KEEPIT 
already  exists 


Copy  coded  file(s)  displaying  EORs  and  EOFs  in  the  receiving 
file. 

Syntax:  SCOPY, lfn_in,lfn_out,n,fchar, lchar ,na,R , f cs , 

f 1 ine , 1 1 ine , ns . 


Parameters:  n 


-  decimal  number  of  files  to  copy 
(default:  copy  to  EOI) 


Remarks : 


fchar  -  first  character  position  of  line  to  copy 

lchar  -  last  character  position  of  line  to  copy 

na  -  do  not  abort  if  no  line  terminator 

before  EOR 

R  -  rewind  lfnin  and  lfnout  before  copying 

fcs  -  character  set  of  lfnin 

0  -  display  code  or  6/12-bit  display 
code 

(default:  0;  no  other  value  allowed) 

fline  -  first  line  of  (sequenced)  file  to  be 
copied 
(default:  1) 

lline  -  last  line  of  (sequenced)  file  to  be 
copied 

(default:  controlled  by  n) 

ns  -  any  non-null  value  to  suppress  EOR/EOF 
display  in  lfnout 

Do  not  use  with  S,  L,  F  or  SI  tapes. 

A  file  without  an  EOR  will  have  one  added  to  the 
end  of  the  listing. 
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See  also:  COPY  (S,  L,  F  tapes),  TCOPY  (SI  tapes) 

Examples:  SCOPY,myf ile. 

SCREEN  (IAF)  Set  your  terminal  for  screen  mode. 

Syntax:  SCREEN, TM=model . 

SCREEN, model . 

Parameters:  model  -  the  terminal  mode 


model 

meaning 

DTI  00 

DEC  VTlOO-compatible  for 

FSE  at  DTRC 

VT100 

alternate  DEC  VT100- 

compatible 

other 

call  User  Services 

omitted 

no  change 

modelT  -  append  T  for  type-ahead  capability 

Remarks:  SCREEN  may  be  included  in  a  procedure. 

Affects  FSE,  HELPME,  screen  formatting,  and  the 
display  of  NOS  procedure  parameters. 

You  may  wish  to  put  "SCREEN, DTI 00. "  into  your 
LOGINPR  file. 

See  also:  LINE 

Similar  commands:  NOS/VE:  CHANGE_ INTER ACT ION_STYLE 

Examples:  SCREEN, DT100  < —  set  for  full-screen  editing 

FSE,myf ile,G.  < —  edit  in  full-screen  mode 


SET  Assign  a  value  to  a  control  register,  an  error  flag,  or  the 

enter-skipped-commands-in-the-dayf i  1  e  flag,'  change  the  current 
interactive  subsystem. 

Syntax :  SET, symbl=expl , symb2=exp2, . . . , symbn=expn. 

Parameters:  symbi  -  one  of: 


name 

meaning 

Rl,  R2 ,  R3 

local  control  registers 
(initial  value:  0) 

RIG 

global  control  register 
(initial  value:  0) 

EF 

local  error  flag 
(initial  value:  0) 
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EFG 

global  error  flag 
(initial  value:  0) 

DSC 

dayf i le_skipped  command 
flag 

0  -  do  not  put  skipped 

commands  into  dayfile 
1  -  put  skipped  commands 
into  dayfile 
(initial  value:  0) 

PL  or  PS 

page  length  (or  page  size) 
(default:  60) 

PW 

page  width 
(default:  136) 

PD 

page  density 

(default:  6  lines  /  inch) 

SS 

interactive  subsystem 

expi  -  any  valid  expression 

symbol  range 


Rl.  R2.  R3.  RIG  -131071  to  131071 


EF,  EFG 
DSC 

PL  or  PS 

PW 

PD 

SS 


Similar  commands:  COS:  SET 

NOS/VE:  var 
VMS:  $  va 


0  to  63 
1  or  0 
16  to  255 
40  to  255 
6  or  8 

ACCESS,  BASIC,  BATCH, 
EXECUTE,  FORTRAN, 
FTNTS ,  NULL 


value  (SCL) 

=  value  (DCL) 


Examples:  SET,R1=0. 

WHILE, R1=5,L00PEND. 

SET,R1=R1+1. 

ENDW, LOOPEND. 


SETASL  Set  the  SRU  limit  for  an  accounting  block. 

Syntax:  SETASL, s. 

SETASL,*.  <--  set  to  your  maximum  SRU  limit 

Parameters:  s  -  maximum  number  of  SRUs  allowed 

(decimal,  or  octal  with  B  suffix) 

(generally,  s  must  be  >=  the  current  job  step 
SRU  count  and  <=  your  SRU  limit) 


See  also:  SETJSL 


Similar  commands:  NOS/VE:  CHANGE  JOB  LIMIT 


Examples : 


SETASL, 2000. 
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SETCORE  Preset  each  word  of  the  field  length  except  for  RA+2. 


SETFS 


SETJOB 


Syntax : 

SETCORE, p. 

SETCORE, -p. 

Parameters : 

p  -  desired  setting  (-p  sets  the  complement  of  p) 
p  fill  characters 

0  0 

ZERO  zeros  (0) 

INDEF  indefinite  (1777  0000  ...  0000) 

INF  infinite  (3777  0000  ...  0000) 

(Default:  0) 

Remarks : 

To  preset  memory  with  a  load  sequence,  use 

LDSET, PRESET. 

Examples : 

RFL, 100000. 

SETCORE.  <_-  immediately  clear  FL  to  0. 

Set  the  auto 
your  job. 

-drop/no-auto-drop  status  of  files  assigned  to 

Syntax : 

SETFS, lfnl, If n2, . . . , 1 fnn/FS=f s . 

Parameters : 

FS=  -  auto-drop  status 
fs  meaning 

AD  auto-drop 

NAD  no-auto-drop 

Remarks : 

Files  with  no-auto~drop  set  are  not  returned  by 
CLEAR,  RETURN (*) ,  or  UNLOAD (*) . 

Examples : 

SETFS, fyl 1 , fyl2/FS=NAD. 

Change  some 

of  the  current  job's  attributes. 

Syntax : 

SETJOB,UJN=ujn,DC=dc,OP=op. 

SETJOB, ujn,dc, op. 

Parameters : 

ujn  -  new  job  name 

dc  -  disposition  code 

dc  meaning 

TO  queue  output  with  wait  disposition 

NO  discard  output  (no  dayfile) 

DF  default  output  processing 
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SETJSL 


SETPR 

SETTL 


op  -  job  processing  option 

op  meaning 

SU  job  remains  suspended  until 
r.-covered  or  timed  out 
TJ  system  terminates  the  job 

See  also:  RECOVER 

Similar  commands:  NCS/VE:  CHANGE_JOB_ATTRIBUTES 

Examples:  SETJOB.xxxxxxx. 

A —  set  UJN  for  banner  pages  (batch 
and  interactive) 

SETJOB,,NO.  < —  discard  file  OUTPUT  (including 
the  dayfile)  after  the  end  of  a 
batch  job 


Set  the  SRU  limit  for  each  subsequent  job  step. 

Syntax:  SETJSL, s. 

SETJSL,*.  < —  set  to  your  maximum  SRU  limit 

Parameters:  s  -  maximum  number  of  SRUs  for  job  step  execution 

Similar  commands:  NOS/VE:  CHANGE_ JOB_LIMIT 
Examples:  SETJSL, 250. 

Do  not  use  at  DTRC. 


Set  the  CPU  time  limit  for  each  subsequent  job  step. 

Syntax:  SETTL, t. 

SETTL,*.  < —  set  to  unlimited 

Parameters:  t  -  maximum  number  of  CPU  seconds  for  job  step 

execution 

(default:  64  decimal) 

See  also:  ENQUIRE,  LIMITS 

Similar  commands:  NOS/VE:  CHANGE  JOB  LIMIT 


Examp  1 es : 


SETTL, 5. 
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(IAF)  Display  a  screen  formatting  panel  for  testing  purposes. 
Syntax:  SHOW, I=panelname. 

Parameters:  1=  -  the  name  of  a  compiled  panel  in  user  library 

PANELIB  or  in  a  global  library  set 

Remarks:  SHOW  is  an  interactive  procedure  (?  for  help). 


SKIP 


Unconditionally  skip  succeeding  commands,  ending  with  an  ENDIF 
with  a  matching  label. 

Syntax:  SKIP, label. 

Parameters:  label  -  alphanumeric  string  (1-10  characters, 

starting  with  a  letter) 

See  also:  ENDIF 

Similar  commands:  VMS:  GOTO 

Examples:  IF (R1<=1 ,D0NE) 

SKIP (DONE) 

IF (R 1=2, DONE) 

SKIP (DONE) 

ENDIF (DONE) 


SKIPEI  Position  a  file  at  end~of-inf ormation. 

Syntax:  SKIPEI, lfn. 

Remarks:  On  magnetic  tape  with  no  EOI  defined,  stops  at 

EOF. 

See  also:  SKIPF,  SKIPFB,  SKIPR 

Similar  commands:  COS:  SKIPD 

VMS:  OPEN  with  ACCESS=APPEND  in  a  program 

Examples:  SKIPEI ,myfile. 


Skip  forward  a  specified  number  of  files. 
Syntax:  SKIPF, lfn, n,m. 


Parameters:  n 


decimal  number  of  files  to  skip 
(default:  1;  max:  262143) 
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SKIPFB 


SKIPR 


m  -  coded  or  binary 
m  meaning 

B  binary 
C  coded 

(default:  B;  C  with  SI  tape  is  fatal) 
Remarks:  Will  stop  at  EOI. 

See  also:  SKIPEI,  SKIPFB,  SKIPR 

Similar  commands:  COS:  SKIPD;  SKIPF;  SKIPR;  SKIPU 

NOS/VE:  SKIP_TAPE_MARK 

Examples:  SKIPF, myf ile,4,C. 

A —  skip  4  coded  files 


Skip  backward  a  specified  number  of  files. 
Syntax:  SKIPFB, lfn,n,m. 

Parameters:  n  -  decimal  number  of  files  to  skip 

(default:  1;  max:  262143) 

m  -  coded  or  binary 
m  meaning 


B  binary 
C  coded 

(default:  B;  C  with  SI  tape  is  fatal) 
Remarks:  Will  stop  at  BOI. 


See  also:  SKIPEI,  SKIPF,  SKIPR 


Similar  commands:  COS:  SKIPD;  SKIPF;  SKIPR;  SKIPU 

NOS/VE:  SKIP  TAPE  HARK 


Examples:  SKIPFB, myf ile, 4, C. 

A —  skip  back  4  coded  files 


Skip  forward  a  specified  number  of  record  or  file  marks. 
Syntax:  SKIPR , 1 fn, n , 1 evel , m. 

Parameters:  n  -  decimal  number  of  files  to  skip 

(default:  1;  max:  262143) 

level  -  level  number  (C  17) 

0-16  -  EORs  and  EOFs  counted 
17  -  EOFs  counted 

(default:  0) 
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m  -  coded  or  binary 
m  meaning 

B  binary 
C  coded 

(default:  B;  C  with  SI  tape  is  fatal) 
Remarks:  Consecutive  EORs  or  EOFs  are  counted  separately. 

Will  stop  at  EOI . 

See  also:  SKIPEI,  SKIPF,  SKIPFB 

Similar  commands:  COS:  SKIPD;  SKIPF;  SKIPR;  SKIPU 

Examples:  SKIPR,myfile,4, 17. 

A —  skip  4  binary  files 

SLOAD  (Loader)  Selective  load  modules  from  a  file. 

Syntax:  SLOAD, lfn,namel ,name2, . . . ,namen. 

Parameters:  lfn  -  the  file  from  which  the  listed  modules 

are  to  be  loaded 

namei  -  the  name  of  a  module  to  be  loaded 
See  also:  LIBLOAD 

Similar  commands:  VMS:  LINK  f ile/INCLUDE= 

Examples :  SLOAD, myb in, sub a, subb, subg. 

SORT  This  deals  with  sequenced  files  and  is  NOT  the  Sort/Merge 
program. 

Remarks:  S0RT5  is  the  Sort  program;  MERGE  is  the  Merge 

program. 

SORT5  Sort  files. 

Syntax:  FILE, 1 f ninl , . . . . 

FILE, lfnin2, .... 

FILE, lfnout , . . . . 

S0RT5 . pi , p2 , . . . , pn 
or 

SORT5 .pi  p2  ...  pn 
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Parameters : 


Positional :  S0RT5 . f rom, t o, key , dir , 1 , ,e,el , 

dialog, end, , , ownf , ownf 1 , 
owmr  1 , ,  own  1 ,  own2 ,  own3 , 
own4 , own5 , retain, seqa, 
seqn, seqr , seqs , status , sum, , 
verify, fastio. 

Interactive:  SORT5 .DIALOG=YES 

Directive  file:  SORT5 . DIR=1 fn 

S0RT5 . pa rams ,DIR=1 fn 
SORT5 .DIR=lfn,params 
S0RT5 . params ,DIR=lfn, . . 
.«iore_params 


FROM=l fn 

FR0M=(ifnl, lfn2, . . . , lfnn) 

Up  to  100  input  files,  read  in  the  order 
specified,  normally  rewound  before  and 
after  use. 


T0=lfn 

The  file  to  receive  the  sorted  records, 
normally  rewound  before  and  after  use. 

KEY= (key_def ,key_def , . . .) 


key_def 

-  range 

-or- 

(range, type, ad) 

(first, length, type, ad) 

~or~ 

range 

-  first  -or- 

f irst . . last 

first 

-  first  byte/bit  of  key 

field 

last 

-  last  byte/bit  of  key  f 

ield 

length 

-  number  of  bytes/bits  in  key 

(default:  1) 

type 

-  name  of  numeric  data  format 

or  collating  sequence 
("default:  ASCII6) 

ad 

-  order:  A  (ascending) 

D  (descending) 

(default:  A) 

Up  to  100  key-defs  may  be  specified. 

Keys  are  sorted  first  by  the  leftmost 
key_def . 

If  no  keys  are  specified,  KEY=l..mnr 
(minimum  record  length;  smallest  MNR  or 
smallest  FL  or  MRL  on  FILE  statements)  is 
used. 
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DIR=lfn 

DIR= (lfnl , lfn2, . . .) 

Read  S0RT5  parameters  from  one  or  more 
files. 

(default:  no  directive  file  is  read;  the 

parameters  of  the  SORT5  statement 
completely  define  the  sort) 

L=1  fn 

Output  listing  information. 

(default:  OUTPUT) 

E=lfn 

Error  listing  file. 

(default:  the  L=  file) 

EL=el 

Error  level  to  be  reported: 

T  -  trivial  +  W,  F,  C 
W  -  warning  +  F,  C 
F  -  fatal  +  C 
C  -  catastrophic 
(default:  W) 

DIALOG=YES  or  DIA=Y 

Interactive  dialog.  Hay  appear  only  in  the 
S0RT5  control  statement.  All  information 
for  the  sort  is  entered  in  response  to 
questions.  All  other  parameters  specified 
in  the  S0RT5  statement,  except  STATUS,  are 
ignored. 

ENR=expr 
ENR=expr. . expr 

The  estimated  number  of  records  to  be 
sorted  (single  decimal  integer  0~10**9, 
a  range  of  values,  or  one  of  the  CCL 
variables:  Rl,  R2,  R3,  RIG,  EF,  or  EFG. 

(Use  especially  if  ENR  <  1500) 

RETAIN=retain  or  RET=r 

Specify  the  order  for  records  with  equal 
sort  keys. 

retain  meaning 


YES  or  Y  records  with  equal  keys  retain 
their  original  order 

NO  or  N  records  with  equal  keys  might 

not  retain  their  original  order 
(default:  NO) 
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STATUS=var iable  or  ST=variable 

Report  the  SORT5  status  to  one  of  the  CCL 
variables:  Rl,  R2,  R3,  RIG,  EF,  or  EFG. 


code 

meaning 

0 

no  errors 

20 

trivial 

30 

warning 

40 

fatal 

50 

catastrophic 

Remarks:  Each  line  of  the  SORT5  control  statement  or  the 

directive  file  may  be  up  to  100  characters,  but 
characters  beyond  column  80  are  ignored. 

Batch:  To  continue  on  more  than  one  line,  end  one 
line  with  two  periods  and  start  the  next 
line  with  one  period.  CAUTION:  because  a 
line  range  is  indicated  by  two  periods, 
ranges  must  not  be  continued. 

Interactive:  Lines  cannot  be  continued.  If  more 
than  one  line  is  needed,  use  a 
directive  file  or  a  procedure. 

FILE  statements  are  required  for  each  file.  The 
maximum  record  is  specified  with  the  FL  parameter 
(if  R'V=Z  or  F)  or  MRL  parameter  (all  others). 

In  the  positional  illustration  above,  reserved 
positions  are  indicated  by  adjacent  commas. 

See  Sort/Merge  Version  5  Reference  Manual, 
60484800,  for  other  parameters. 

See  also:  MERGE 

Similar  commands:  COS,  NOS/VE,  VMS:  SORT 

Examples :  FILE, infyl ,BT=C,RT=Z,MRL=80. 

FILE, out fyl , BT=C,RT=Z,MRL=640. 

S0RT5 ,infyl,outfyl,5..10 

A —  sort  columns  5~10  into  ascending 
ASCII6  order 

S0RT5 . FR0M= infyl ,KEY= ( (5 . .10, ,D)) ,T0=outfyl 
A —  same,  except  descending 


SORT5.KEY=6. .25 

A —  sort  one  20-byte  key  starting  in 
byte  6 

SORT5 . KEY= ( (6 , 20) ) 

A —  same  as  above 
S0RT5 . KEY= (6 , 20) 

A —  sort  two  1-byte  keys  (major  key 
in  byte  6,  minor  key  in  byte  20) 
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S0RT5.KEY=6,20 

A —  sort  byte  6,  read  directives 
from  local  file  "20"  (this  is 
the  next  positional  parameter) 

STIME  Put  the  accumulated  SRU  value  for  the  job  into  the  dayfile. 
Syntax:  STIME. 

See  also:  CTIME,  ENQUIRE, S,  RTIME 

Similar  commands:  VMS:  AT 
Examples:  STIME, 


SUBMIT  Put  a  job  into  the  input  queue. 

Syntax:  SUBMIT, lfn, q, NR. c 


Parameters:  lfn  -  the  file  to  be  submitted  -  the  first  record 

must  be  in  6~bit  display  code 

q  -  output  disposition 

BC  or  B  -  central  site 

NO  or  N  -  discard  output  unless 

specifically  routed  within  the 
batch  job  -  no  dayfile 
RB=un  -  route  output  to  a  remote 

batch  terminal  or  interactive 
user 

TO  -  queued  with  wait  disposition 

(Default:  TO) 

NR  -  do  not  rewind  the  submit  file  or  cREAD  file 
before  or  after  processing 
(Default:  rewind) 


c  -  prefix  character  for  reformatting 

directives  in  the  file  (assumes  /JOB  is  the 
first  statement) 

(Default:  /) 


Remarks:  For  both  direct  and  indirect  files. 


See  also:  CSUBMIT,  ROUTE 


Similar  commands:  COS:  SUBMIT 

NOS/VE:  SUBM1T_J0B 

VMS:  SUBMIT:  CRAY  SUBMIT:  CSUBMIT  (DTRC) 
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SWITCH 


TAPDMP 


Examples : 


SUBMIT , my j  ob , BC . 

A —  print  at  Central  Site 
SUBMIT , my j  ob ,RB=xxxx . 

A —  use  QGET  to  retrieve  output 
print  queue 

SUBMIT, my job, TO. 

A —  use  QGET  to  retrieve  output 
wait  queue 


from 


from 


Set  sense  switches. 


Syntax:  SWITCH, swi tch_l , swi tch_2, ...» swi tch_n, j  sn. 

Parameters:  switch_i  -  switch  to  be  set  ( 1 — 6) 

0  -  set  all  switches 

jsn  -  may  appear  in  any  parameter  position 

(Default:  the  current  job) 

Similar  commands:  COS:  SWITCH 

NOS/VE:  SET_SENSE_S WITCH 

Examples:  SWITCH, 1 , 3, 13 

A —  turn  on  sense  switches  1,  3,  5 


(DTRC)  Driver  to  execute  TAPEDMP  program. 


Syntax:  BEGIN, TAPDMP, ,L, SLOT, VSN,D,CV, LB, 

NF I LE , NREC , MODE , I START , PRCODE , 
PRFILE , NUMPRT , PECODE , LENGTH , 

I , KEEP , VSNA. 


Parameters : 


L  -  listable  output  file 
(default:  OUTPUT) 

SLOT  -  Slot  number 

VSN  -  Volume  Serial  Number 

D  -  Tape  density 

9-track:  GE  or  6250;  PE  or  1600;  HD  (800) 
(default:  PE) 

CV  -  Tape  conversion  mode  (AS  or  EB) 

(defaults:  omitted:  no  conversion  (binary); 
keyword:  AS) 

LB  -  Tape  labelling 
lb  meaning 


I 


KL  labelled 
KU  unlabelled 

(defaults:  omitted:  KU;  keyword:  KL) 

-  input  file  containing  your  NAMELIST 
statement 

(if  I=INPUT,  the  NAMELIST  statement  mus 
be  entered  on  one  line) 

(default:  TAPDMP  will  generate  the 

NAMELIST  statement) 
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KEEP  -  tape  disposition 

K  or  KEEP  -  do  not  reposition  the  tape 
R  or  REWIND  -  rewind  the  tape 
other  -  unload  the  tape 

Use  K  or  R  if  you  wish  to  dump  more  of  the 
tape  without  remounting  it  each  time 
(default:  the  tape  is  unloaded) 

VSNA  -  alternate  VSN 

(e.g.,  if  external  sticker  is  NA0123 
but  internal  VSN  is  NA0123,  use  both  VSN 
and  VSNA) 

Remarks:  See  the  description  of  TAPEDMP  for  the  following 

parameters:  NFILE,  NREC ,  MODE,  ISTART,  PRCODE, 
PRFILE,  NUMPRT,  PECODE,  LENGTH. 

Not  all  features  of  TAPEDMP  are  supported  by 
TAPDMP .  Use  TAPEDMP  directly  for  them. 

Use  TDUMP  to  dump  a  7-track  tape. 

See  also:  TAPEDMP,  TDUMP 

Similar  commands:  NOS/VE:  DISPLAY_FILE 

VMS:  DUMP 

Examples:  BEGIN, TAPDMP ,, out 1 , 99 .mytapl , NFILES=2 . 

A —  analyze  the  first  t2o  files  with 
output  to  file  OUT1  —  since  then 
tape  is  mounted  unlabelled  -  the 
first  file  could  be  the  label 


BEGIN, TAPDMP, ,out2, 99, mytapl ,CV=AS,M0DE=0, 
PRCODE=2. 

A —  alphanumeric  dump  of  ASCII  tape 


BEGIN , TAPDMP , , ou 1 3 , 99 , mytapl, CV=EB , M0DE=2 , 
PRC0DE=4. 

A —  hexadecimal  dump  of  EBCDIC  tape 


BEGIN , TAPDMP , , ou t4 , 99 , mytapl ,NFILE=2, KEEPER . 

A —  analyze  the  tape;  rewind  after 
<use  FSE  to  examine  summary  output  in  file  OUT4> 
BEGIN , TAPDMP , , out  5 , 99 , my t  ap 1 , M0DE=0 , PRC0DE=2 , 

NFI LE=2 , PRFILE=2 , NREC=10 . 

A —  alphanumeric  dump  of  the  first 
10  records  of  file  2 
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TAPEDMP 


(DTRC)  Analyze  a  magnetic  tape. 

Syntax:  TAPEDMP, inf ile,outfile. 

Parameters:  infile  -  input  directives  in  Fortran  NAMELIST 

form  ($NPUT  ...  SEND) 

(default:  INPUT) 

outfile  -  listable  output 

(default:  OUTPUT) 

Remarks:  TAPEDMP  was  obtained  from  NASA. 

TAPEDMP  performs  the  following  functions: 

Analyze:  determine  the  recording  mode  (ASCII, 
EBCDIC,  or  binary  for  9~track;  BCD  or 
binary  for  7-track)  and  summarize  the 
analysis  of  a  specified  number  of  data 
blocks . 

Dump:  print  the  data  in  either  alphanumeric, 
octal,  hexadecimal,  or  external  BCD. 

List  all  magnetic  tape  labels. 

If  TAPEDMP  is  executed  interactively,  the  output 
is  formatted  for  80-character  outout. 

The  tape  must  be  mounted  as  local  file  TAPE1  and 
positioned  properly. 

Extreme  caution  should  be  exercised  when  using 
the  detail  print  options  to  avoid  voluminous 
output . 

For  7-track  tapes,  if  a  mode  is  specified,  an 
attempt  to  read  at  this  mode  will  be  made  and,  if 
there  is  an  error,  the  mode  will  be  switched. 

In  the  printout,  ASCII/BCD  for  coded  tapes 
indicates  ASCII  for  9-track  and  BCD  for  7-track. 

When  detailed  printing  (PRCODE)  is  requested,  the 
unused  bit  count  will  be  indicated  for  each 
record. 

TAPEDMP  attempts  to  process  all  errors  and 
overrides  system  aborts  which  would  normally 
occur.  If  TAPEDMP  cannot  continue,  the  following 
message  is  issued  to  the  dayfile: 

SYSTEM  ABORT  -  ERROR  FLAG=xx 
where  xx  is  the  RPV  (REPRIEVE)  error  code. 
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Directives:  The  directives  are  specified  in  Fortran  NAMELIST 

form  ($NPUT  ...  SEND)  using  the  following 

variables : 

ISTART  =  record  number  to  begin  printing 
(default:  1) 

LENGTH  =  length  in  words  of  the  longest  block  to 
be  read  -  if  >  514,  RFL  and  REDUCE(-) 
are  required  to  increase  the  execution 
field  length  to  23100  (octal)  by  the 
amount  over  514 
(default:  514) 

L0  =  list  label  option  (requires  LB=KU  and 
F=S  or  F=L  in  the  LABEL  statement) 

0  -  do  not  list  labels 

<>0  -  list  all  tape  labels  (when 
selected,  all  other  TAPEDMP 
parameters  are  ignored) 

(Similar  information  is  availble  from 
the  LISTLB  command) 

(default:  0) 

MODE  =  processing  mode  for  magnetic  tape 

0  -  ASCII  for  9-track;  BCD  for  7-track 

1  -  binary 

2  -  EBCDIC  for  9-track  (requires  CV=EB 

in  the  LABEL  statement) 

4  -  analyze  data/determine  correct  mode 
(default:  4) 

NFILE  =  number  of  files  to  analyze 
(default:  1) 

NREC  =  number  of  records  to  analyze 
(default:  all  records) 

NUMPRT  =  number  of  records  per  file  to  print 
(default:  all  records) 

PEC0DE  =  parity  error  print  code 

1  -  no  parity  error  print 

0  -  print  parity  error  code  according 
according  to  PEC0DE  (if  PECODE^O, 
it  is  printed  in  octal) 

(default:  1) 

PRCODE  =  detail  print  code 

0  -  no  detail  print 

1  -  octal 

2  -  alphanumeric 

3  -  octal  and  alphanumeric 

4  -  hexadecimal  (9-track  only) 

5  -  external  BCD  (7-track  only) 
(default:  0) 
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PRFILE  =  file  number  in  which  to  start  detail 

print  ~  printing  continues  through  NFILE 
(default:  1) 

Messages:  END  OF  TAPEDMP 

END-OF-TAPE  ENCOUNTERED,  TAPE  DUMP  TERMINATED 

The  end  of  this  tape  has  been  encountered. 

EOF  ENCOUNTERED 

A  physical  tape  mark  was  encountered. 
INVALID  INPUT  DATA 

NAMELIST  data  invalid  or  used  incorrectly. 

LENGTH  IS  NOT  GT  THAN  ZERO 

A  system  error  has  occurred  in  creating  the 
file  buffer  -  increase  the  value  of  LENGTH. 

LEVEL  17  EOF  ENCOUNTERED 

A  software-created  level  17  EOF  was 
encountered. 

TAPE  IS  NOT  LABELLED 

LO<>0  was  requested  but  no  tape  labels  were 
found  -  be  sure  LB=KU  is  in  the  LABEL 
statement . 

TAPEl  MUST  BE  A  TAPE  FILE 

See  also:  LISTLB ,  TAPDMP ,  TDUMP 

Similar  commands:  NOS/VE:  DISPLAY_FILE 

VMS :  DUMP 

Examples:  Three  ways  of  dumping  (alphanumeric)  20  records 

from  file  1  of  ASCII  tape  MYTAPl  in  SLOT99. 

Batch: 

j  obname , . . . . 

USER, . . . . 

CHARGE, .... 

LABEL, TAPEl , D=PE , F=L, PO=R , VSN=SLOT99=mytapl , 
LB=KU. 

ATTACH, UTILITY/UN=NSYS. 

LDSET,  LIB=UTILITY .  <—  or  LIBRARY , UTI LITY . 

TAPEDMP. 

<eor> 

SNPUT  NREC=20,  PRC0DE=2,  M0DE=2  SEND 
<eoi  > 
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Interactive : 

NOTE, in./  $NPUT  NREC=20,  PRCODE=2,  MODE=2  $END 

LABEL, TAPE  1 , D=PE , F=L , PO=R , VSN=SL0T99=myt apl , LB=KU 

ATTACH, UTILITY/UN=NSYS 

LIBRARY, UTILITY 

TAPEDMP, in 

REWIND, TAPE1 


Via  procedure  TAPDMP: 

BEGIN, TAPDMP, , , 99 , my tap  1 , NREC=20 , PRCODE=2 ,MODE=2 . 
-or- 

BEGIN, TAPDMP, , ,99,mytapl , .,, ,20,2,2. 


$NPUT  NFILE=4, 

PRCODE=2 , 

NUMPRT=3, 

$END 

A —  short  output  which  tells  most  of 
what  you  want  to  know  about  the 
tape 


TCOPY  Copy  X  (binary),  E,  B,  or  SI  (coded)  tapes  to  disk,  I,  or  SI 
(binary)  tape. 


Syntax:  TCOPY, lfn_in, lfn_out, format, tc, copycnt , charcnt , 

er limit ,plp2, lfnlst ,ns. 


TCOPY, l=lfn_in,0=lfn_out ,F= format ,TC=tc, 

N= copycnt ,CC= charcnt , EL=er 1 imi t , PO=plp2 , 
L=1 fnls  t , NS=ns . 

Parameters:  1=  ~  input  file  to  be  copied 

(default:  INPUT) 

0=  -  the  output  copied  file 

(default:  OUTPUT) 


CC=  -  used  for  obsolete  E  or  B  tapes 


EL=  -  number  of  non-fatal  errors  before  abort; 
EL=U  for  unlimited  error  processing 
(default:  0;  ignored  for  E/B  output  or 
terminal  input) 


F= 


type  of  conversion 
format  meaning 


E 

B 

X 

SI 


(default : 


obsolete 

obsolete 

obsolete 

SI  coded  tape  to  disk  (SI  tape  is 
labelled  or  unlabelled  and 
assigned  as  S) 

X) 
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I  DU 


L=  -  alternate  file  for  pj-ity  error  messages 
for  EL<>0;  cannot  be  same  as  I=,  0= 
(default:  OUTPUT) 

N=  -  copy  count  (meaning  determined  by  TO) 
(default:  N=l) 

NS=  -  noise  size  for  E  to  B  conversion 

(maximum:  41;  NS=0  uses  default  of  18) 


P0=  -  processing  options: 

pi  meaning 


E  copy  input  blocks  with  parity  or 
block-too-long  errors 
(default:  error  blocks  skipped) 

T  truncate  long  blocks  for  E/B  output 

(default:  split  into  multiple  blocks) 


TO  -  termination  condition  with  N= 
tc  meaning 


F  or  EOF  N  is  number  of  files 

I  or  EOI  N  is  ignored 

(copy  to  end-of-inf ormat i on) 

D  or  EOD  N  is  number  of  double  EOFs  to 
copy  to 

(default:  TOD) 


See  also:  COPY  (S,  L,  F  tapes),  SCOPY  (display  EOR/EOF) 

Similar  commands:  NOS/VE:  DISPLAY  FILE 


Examples:  TCOPY , tape , di sk , SI . 

A —  copy  a  complete  coded  NOS/BE 
tape 


(IAF)  Compile  a  terminal  definition  file  and  store  it  in  a 
user  library  which  can  later  be  accessed  by  a  SCREEN  or  LINE 
command . 

Syntax :  TDU, I=definition,L=listing,LIB=library. 

Parameters:  1=  -  the  terminal  definition  file  in  6/12~bit 

display  code 

L=  -  the  output  listing  file 
(default:  OUTPUT) 

LIB=  -  the  library  to  receive  the  load  capsule 
(default:  TERMLIB) 

Remarks:  TDU  may  appear  in  a  procedure. 


Similar  commands:  NOS/VE:  DEFINE  FILE 
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TDUMP  Octal  or  alphanumeric  dump  of  all  or  part  of  a  file. 

Syntax:  TDUMP , pi , p2, pn. 

Parameters:  I=lfn  -  local  file  to  be  dumped 

(default:  TAPE1) 

L=lfn  -  listable  output  (never  rewound) 
(default:  OUTPUT) 

0  -  octal  dump  only 

A  -  alphanumeric  dump  only 

(if  both  specified,  last  is  used) 
(default:  octal  and  alphanumeric) 

R=rcount  -  decimal  maximum  number  of  records  to 
dump  (restarts  for  each  file) 

(default:  omitted  or  R=0:  dump  to  EOI) 

F=fcount  -  decimal  maximum  number  of  files  to  dump 
(default:  dump  to  EOI;  F=0  *>  dump 
until  double  EOF  or  EOI) 

N=ncount  -  decimal  maximum  number  of  output  li"nes 
with  each  output  line  containing  40 
input  characters 

(default:  omitted  or  N=0:  dump  to  EOI) 

NR  -  do  not  rewind  input  file 

See  also:  TAPEDMP 

Similar  commands:  NOS/VE:  DISPLAY_FILE 

Examples:  LABEL, TAPEl . 

TDUMP . 


TDUMP, R=5,N= 100. 

A —  dump  5  tape  records  but  no  more 
than  100  output  lines 

TPAUDIT  (DTRC)  Audit  the  magnetic  tapes  assigned  to  you. 

Syntax:  BEGIN, TPAUDIT. 

See  also:  TPGET,  TPRLS 

Examples:  BEGIN, TPAUDIT. 


TPGET  (DTRC)  Get  up  to  3  magnetic  tapes  for  use  on  the  CDC  CYBER  860 
or  DEC  VAXcluster. 


Syntax : 


BEGIN, TPGET. 
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Remarks:  You  will  be  asked  how  many  tapes  you  want  and 

then,  after  they  have  been  selected,  to  verify 
that  you  want  them. 

See  also:  TPAUDIT,  TPRLS 

Examples:  BEGIN, TPGET. 

TPRLS  (DTRC)  Release  magnetic  tapes  assigned  to  you  by  TPGET. 

Syntax:  BEGIN, TPRLS. 

Remarks:  You  will  be  asked  the  numbers  of  the  tape(s) 

to  be  released,  and  to  verify  that  they  are  to  be 
released. 

See  also:  TPGET,  TPRLS 

Examples:  BEGIN, TPRLS. 

TRMDEF  (IAF)  Change  terminal  characteristics .  Use  in  your  prologue 

to  set  terminal  characteristics  if  you  normally  use  a  terminal 
other  than  the  default  kind. 

Syntax:  TRMDEF , L=1 fn , tcl=vl , . . . , tcn=vn. 

Parameters:  L=lfn  -  listable  output 

tci=vi  -  new  terminal  character istic  (s) 


tci 

meaning 

EP 

echoplex  mode 

YES 

-  full  duplex 

NO 

-  half  duplex 

PW 

page 

width  (20~255) 

0  - 

infinite 

FL 

fold 

long  lines 

ON 

-  fold 

OFF 

-  do  not  fold 

vi  meaning 


v  any  alphanumeric  character 

(e.g.,  $*$;  display  code  0-44B) 
$v$  any  character  (dol lar-del imi ted) 

(for  user  $$$$) 

vvvB  octal  value  ASCII  character 

(e.g.,  52B  (same  as  $*$)) 
vvD  decimal  value  of  ASCII  character 

(e.g.,  42D  (same  as  $*$)) 
hexadecimal  value  of  ASCII 
character 

(e.g.,  X2A  (same  as  $*$)) 


Hvv 
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Similar  commands:  NOS/VE:  CHANGE_TERMINAL_ATTRIBUTES; 

SET_TERMINAL_ATTR IBUTES 
VMS:  SET  TERMINAL 

Examples:  TRMDEF,EP=Y.  < —  put  into  LOGINPR  to  set  terminal 

to  half  duplex  (echo  on)  for 
this  login 

TRMDEF,PW=132, FL=0FF. 

A —  set  terminal  to  132  characters 
and  do  not  fold  lines 


ULIB  Create  a  user  library;  add,  delete  or  replace  a  record. 

Syntax:  ULIB ,OP=operat ion,REC=record, LIB=1 ibrary. 

ULIB, operation, record, library. 

ULIB?  < —  help  about  command  and 

prompting  for  parameters 

ULIB , parameter?  < —  help  on  the  parameter  and 

prompting  for  parameters 

Parameters:  0P=  -  one  of  the  following  operations 

operation  meaning 


C  create  a  new  user  library 

A  add  a  record  (same  as  R) 

D  delete  a  record 

R  replace  a  record  (same  as  A) 

F  fetch  a  record  and  make  it 

local 

REC=  -  name  of  the  record  to  be  added,  deleted, 
replaced,  or  extracted  (must  be  the  name 
of  a  local  file) 

LIB=  -  the  local  library  file  to  be  created  or 
modified 

Remarks:  Affects  only  the  local  copy.  Use  SAVE  or  REPLACE 

to  make  the  library  permanent. 

For  0P=A,  D  or  R,  ULIB  returns  the  original 
library  an  creates  a  new  local  file  —  so  ULIB 
cannot  modify  a  library  on  a  direct  file. 

Similar  commands:  COS:  UPDATE 

VMS:  CMS;  LIBRARIAN;  INCLUDE  (in  FORTRAN) 

Examples:  ULIB,C, ,mylib. 
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UNIROUT 


UNLOAD 


UNLOCK 


(DTRC)  Shift  a  UNICOS  ASCII8  file  and  print  it. 

Syntax:  BEGIN, UNIR'""'T, , FROM=from,UJN=ujn,STTE=site, 

REP=rep . 

Parameters:  FROM  -  the  ASCII8  file  to  be  printed 

UJN  -  the  jobname  (cover  sheet  banner) 

(A— 7  alphanumeric  characters  starting  with 
User  Initials) 

SITE  -  the  print  site 
site  meaning 

C  print  at  Central  Site  (Carderock) 
(default:  C) 


REP  -  the  number  of  extra  copies  to  print  (0~31) 
(default:  0  (print  original  and  no  extra 
copies) ) 

Remarks:  This  is  useful  for  printing  batch  job  output  from 

UNICOS  on  the  Cray. 

See  also:  ROUTE 


Examples:  BEGIN, UNIROUT, , crayout , abcduni , A. 


Release  files  assigned  to  your  job  and  perhaps  their  file 
space . 

Syntax:  UNLOAD, lfnl , lfn2, ..., lfnn.  < —  specified  files 

UNLOAD,*, lfnl, lfn2, ...» lfnn.  < —  all  but 

specified  files 

Similar  commands:  NOS/VE:  RELEASE_RESOURCE 
Examples:  UNLOAD,myfile. 


Rescind  the  LOCK  command  and  clear  the  write  interlock  for 
specified  local  disk  files. 

Syntax:  UNLOCK, lfnl , lfn2, . . . , lfnn. 

Remarks:  Library  files  cannot  be  unlocked. 

See  also:  LOCK 


Examples : 


See  LOCK. 


90/09/30 


RevO 


Page  1-123 


UPDATE 


Create,  edit  or  copy  a  program  library. 

Syntax:  UPDATE, pi, p2, ... ,pn. 

Parameters:  Note:  file  parameters  (C,  G,  I,  K,  N,  0,  S,  T) 

may  be  followed  by  6  (6— b i t  display  code) 
or  8  (7-bit  ASCII  —  also  requires  18) 

pi  meaning 


A 


copy  old  sequential  PL  to  new 
random  access  PL 


B 

C=lfn 

C=PUNCH 

C 

omitted 

C=0 

D 

omitted 


copy  old  random  access  PL  to  new 
sequential  PL 

write  compile  file  on  lfn 

implies  D  and  8  parameters 

same  as  C=C0MPILE 

same  as  C=C0MPILE 

no  compile  output 

(Note:  C  is  ignored  if  K  is  used) 

compile  file  is  80  characters 
compile  file  is  72  characters 


E  edit  the  old  PL 

(to  completely  edit,  use  E  on  two 
UPDATE  commands  —  the  first  will 
rearrange  the  directory  and  remove 
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F 

G=lfn 

omitted 

H=n 


I=lfn 

1=0 

omitted 


K=lfn 

K 

omitted 

L=clc2. 


M=lfn 

M 

o mi t  ted 


purged  identifiers  —  the  second 
will  remove  identifiers  appearing 
only  in  the  file's  directory 

full  UPDATE  mode 


output  file  for  PULLMOD  directives 
appended  to  the  S  file 


one  of: 

3 

4 

omitted  - 


use  63-character  set 
use  64-character  set 
use  old  PL  char  set 


primary  input  directive  file 
no  input  directives 
same  as  I=INPUT 

(Note:  6/12_bit  ASCII  if  INPUT  is 
connected,  else  6~bit 
display  code) 

compile  file  with  decks  in  order  of 

COMPILE  directives 

same  as  K=COMPILE 

no  input  *C0MPILE  directives 

.cn  list  options  —  one  or  more  of: 

A  -  list  deck  names,  correction 
set  identifiers,  COMDECK 
directives,  definitions, 
compile  file  decks 
F  -  same  as  L=A123456789  (not  0) 

0  -  no  listing 

1  -  error  lines 

2  -  active  UPDATE  directives 

3  -  notes  on  each  line  with 

changed  status 

4  -  text  lines 

5  -  active  compile  file 

directives 

6  -  active  and  inactive  lines 

7  -  all  active  lines 

8  -  all  inactive  lines 

9  -  correction  history  of  options 

5,  7,  8 

Defaults:  L=A1234  (correction  run) 
L=Al  (copy) 


merge  with  old  PL 
same  as  M=MERGE 
no  merging 

(Note:  both  libraries  must  have  the 
same  character  set) 
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N=1  fn 
N 

N=0 

omitted 


0=1  fn 
0=0 

omitted 

P=lfn/sl/s2/. 

P 

P=0 

omitted 


Q 

R=clc2. . c4 


R 

omitted 

S=lfn 

S 

s=o 

omitted 
T=1  fn 


U 

w 

omitted 


X 

omitted 

8 

orai t  ted 


new  program  library 
same  as  N=NEWPL 
no  new  program  library 
same  as  N=0 

(Note:  default  character  set  is 
that  of  OLDPL  (except  if 
0LDPL  is  6~bit  display  code 
and  I  file  is  7~bit  ASCII, 
then  NEWPL  is  7-bit  ASCII)) 

listabie  output  file 
no  listabie  output 
same  as  0=0UTPUT 

../si 

the  old  program  library 

same  as  P=0LDPL 

no  old  program  library 

same  as  P=0LDPL 

(si  are  secondary  old  PLs) 

quick  mode  (process  only  decks  on 
COMPILE  directives) 

files  to  rewind  before  and  after 
C  -  compile  file 

N  -  new  PL 

P  ~  old  and  merge  PLs 

S  -  source  and  PULLMOD  files 

no  rewind 

same  as  R=CNPS  (not  merge  PL) 

output  source  file 
same  as  S=S0URCE 

no  output  source  file  unless  T=lfn 
is  specified 
same  as  S=0 

same  as  S=lfn,  except  that  common 

decks  are  excluded 

(Note:  takes  precedence  over  S) 

do  not  abort  for  fatal  errors 

the  new  PL  is  sequential 
the  new  PL  is  random  (except 
sequential  on  magnetic  tape) 

compile  file  is  compressed 
compile  file  is  not  compressed 

compile  file  is  80-character  lines 
compile  file  is  90-character  lines 
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UPROC 


=  char 


omi t  ted 


master  control  character  (any  6_bit 
octal  value  01-50,  53-54) 
master  control  character  is  * 


/=char 

omitted 


comment  control  character  (A~Z, 

0-9,  +-*/$-) 

master  control  character  is  / 
(Note:  do  not  use  a  command  abbre¬ 
viation  for  <char>  unless 
NOABBREV  is  in  effect) 


See  also:  Section  5-4 


Similar  commands:  COS:  UPDATE 

NOS/VE:  EXTRACT_SOURCE_LIBRARY;  SOURCE 
CODEJJTILITY  (SCU) 

VMS:  CMS;  LIBRARIAN 


Examples:  NOTE,uin. /’'‘COMPILE  A,B,C 

UPDATE, I=uin. 

FTN5 , I . 

RETURN, uin. 

EXIT. 

RETURN, uin. 

/UPDATE.  < —  interactive 

?  *c  a,b,c  < —  enter  UPDATE  directive (s) 

?  <CR>  < —  end-of-file 


Specify  a  user  prologue  to  be  executed  each  time  you  start  a 
batch  or  interactive  job. 


Syntax:  UPROC, FN=pfi le. 

UPROC, pfile. 


Parameters:  pfile  -  an  indirect  permanent  file  containing  the 

prologue 

0  -  no  longer  execute  a  user  prologue 
(Default:  0) 


Remarks:  LOGINPR  is  the  preferred  name. 

UPROC  is  normally  executed  only  once  to  let  NOS 
know  that  <pfile>  is  to  be  executed  at  the  start 
of  each  login. 

If  you  purge  your  prologue  file,  be  sure  to 
execute  "UPROC."  or  "UPROC, 0."  to  prevent  future 
batch  jobs  from  aborting. 

See  also:  page  1-4-1 

SIMILAR  commands:  NOS/VE:  existence  of  your  file  PROLOG 

VMS:  existence  of  your  file  LOGIN.COM 
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USER 


VERIFY 


Examples:  /FSE, loginpr . 

<  create  your  procedure  > 
??  QR  < —  save  the  file 
/UPROC, loginpr. 


Identify  you  and  provide  validation  information  for  each  batch 
j  ob. 


Syntax:  USER, username, password 

Parameters:  username  -  your  4-character  User  Initials 

password  -  your  4-  to  7-character  password 
Remarks:  This  must  immediately  follow  your  job  statement. 

Similar  commands:  COS:  ACCOUNT 
Examples:  USER, xxxx.mypw. 


Compare  files  in  binary  mode. 


Syntax:  VERIFY, lfnl , lfn2,pl ,p2, . . . ,pn. 

Parameters:  lfnl  -  first  file  to  be  compared 

(default:  TAPEl) 

1 f 1 2  -  second  file  to  be  compared 

(default:  TAPE2) 


A  -  abort  after  completion  if  errors 

BS=bs  -  maximum  block  size  for  S,  L  tapes 

(defaults:  1000B  words  (S) ,  2000B  (L)) 

C  -  both  files  coded  (S,  L  tapes  only) 

Cl  -  first  file  coded  (S,  L  tapes  only) 

C2  -  second  file  coded  (S,  L  tapes  only) 

E=y  -  maximum  number  of  errors  to  list 

(default:  100) 

E  -  same  as  E=0 


L=lfn  -  error  output  file 
(default:  OUTPUT) 

N=x  -  number  of  files  of  multi-file  file 
(default:  1) 

N  -  compare  until  EOI  tn  both  files 

N=0  -  compare  until  empty  file  in  either  file 

R  -  rewind  both  files  before  and  after 
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VFYLIB 


VSN 


Remarks:  On  mismatch,  the  record  number,  word  within  the 

record,  and  the  words  from  both  files  which  do 
not  match  are  listed. 

Your  terminal  should  be  in  NORMAL  mode  (not 
ASCII)  before  listing  VERIFY  output  at  your 
terminal . 

See  also:  VFYLIB 

Similar  commands:  COS:  COMPARE 

NOS/VE:  COMPARE_FILES 

Examples:  VERIFY, fyll , fy!2,N,R. 


List  differences  in  name,  type,  length,  and  checksum  for  the 
records  of  two  library  files. 


Syntax :  VFYLIB , 1 fn_l , 1 f n_2 , 1 f n_3 , NR . 

Parameters:  lfn_l  -  first  file 

lfn_2  -  second  file 

lfn_3  -  the  listable  output  file 

NR  -  do  not  rewind  lfn_l  and  lfn_2  after 
processing 


Defaults : 
Remarks : 


See  also: 


VFYLIB , OLD, NEW , OUTPUT. 

lfn_l  and  lfn_2  are  rewound  before  comparing. 

Your  terminal  should  be  in  NORMAL  mode  (not 
ASCII)  before  listing  VFYLIB  output  at  your 
terminal . 

VERIFY  (binary  comparison) 


Similar  commands:  COS:  ITEMIZE 

NOS/VE:  COMPARE_OBJECT_LIBRARY 
VMS:  DIFFERENCES 


Examples:  VFYLIB , fyl 1 , fyl2 , out . 


Associate  a  local  file  name  with  one  or  more  volume  serial 
numbers . 

Syntax:  VSN, 1 f n_l=vsn_l , 1 f n_2=vsn_2 , . . . , lfn_n=vsn_n. 


Parameters:  lfn  i  -  local  file  name 
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vsn_i  -  1-  to  6-character  vsn's  to  be  associated 
with  lfn_i 

($_del imi ted  if  any  non-alphanumer i cs) 
vsn_i  meaning 


omitted  any  available  scratch 

tape  is  assigned 
automatically 

0  same  as  omitted 

SCRATCH  same  as  omitted 

vsna=vsnb= . . . =vsnn  duplicate  volumes 

(any  may  be  used) 

vsna/vsnb/ . . . /vsnn  successive  volumes 

(must  be  used  in 
listed  order) 

See  also:  LABEL 

Examples:  VSN,  tape=;NA9876 . 

WHATJSN  (1AF)  Get  the  job  sequence  number  for  the  specified  user  name. 
Syntax:  WHATJSN, username 

Parameters:  username  -  the  username  whose  jsn  is  desired 
Remarks:  You  must  be  in  the  ACCESS  subsystem. 

See  also:  WHO 

Similar  commands:  VMS:  SHOW  USERS 
Examples:  WHO 

WHILE  Start  of  a  command  loop. 

Syntax:  WHILE, exp , label . 

Parameters:  exp  -  any  valid  expression  evaluating  to  true 

or  false 

label  -  alphanumeric  string  (1-10  characters, 
starting  with  a  letter) 

Remarks:  The  loop  ends  with  an  ENDW  statement. 

See  also:  ENDW 

Similar  commands:  COS:  LOOP 

NOS/VE:  WHILE 
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Examples:  WHILE, Rl<5, DOIT. 

SET, Rl=Rl+l . 

ENDW.DOIT. 

WHO  (IAF,  DTRC)  List  the  users  currently  logged  in. 

Syntax:  WHO,lfn. 

Parameters:  lfn  -  output  file 

(default:  OUTPUT) 

Remarks:  The  display  shows  the  total  number  of  users  who 

have  logged  in  since  the  last  system  deadstart, 
the  number  of  active  (logged  in)  users  (the  "D" 
suffix  indicates  a  decimal  number) ,  and  a  table 
showing  the  IAF  connection  number,  User  Initials, 
Job  Sequence  Number,  and  port  number  for  each 
logged-in  user.  An  asterisk  in  the  W  column 
indicates  the  user  has  been  sent  a  Warning 
message  by  the  operator  but  has  not  yet  received 
it  (messages  from  the  operator  while  you  are  in 
FSE  are  not  received  until  you  exit  from  FSE) . 

Similar  commands:  NOS/VE:  WHO  (DTRC) 

VMS:  SHOW  USERS 

Examples:  WH0,whoout.  < —  write  the  display  in  local  file 

WHOOUT 


WHO  < —  display  at  the  terminal 


TOTAL 

USERS  = 

36D 

ACTIVE  USERS  = 

CONN 

USER 

JSN 

W 

TERM 

3 

CARA 

AADD 

T1200 

4 

TLIB 

AAFH 

T1210 

5 

CASG 

AAFW 

T1230 

6 

CTSC 

AAFX 

T1240 

7 

AMDS 

AAFZ 

T1610 

WHO  COMPLETE. 


WHOAMI  (DTRC)  Display  your  user  ID  and  account  number. 
Syntax:  BEGIN, WHOAMI . 

Similar  commands:  NOS/VE:  DISPLAY_JOB_ATTRIBUTE 

VMS :  MYACCOUNT 


Examples : 


BEGIN, WHOAMI. 
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WRITEF  Write  a  specified  number  of  file  marks  on  a  file. 
Syntax:  WRITEF, lfn,x. 

Parameters:  lfn  -  the  file  to  receive  the  file  marks 


x  -  decimal  number  of  file  marks  to  write 
(default:  1;  max:  262143) 

Remarks:  If  previous  write  was  not  an  EOR,  an  EOR  is 

added  before  the  EOF. 


Use  WRITEF  after  FCOPY  when  creating  a  multi-file 
stranger  tape. 

See  also:  WRITER 

Examples:  WRITEF, myf ile, 2. 


WRITER 


Write  a  specified  number  of  empty  records  on  a  file. 

Syntax:  WRITER, lfn, x. 

Parameters:  lfn  -  the  file  to  receive  the  empty  records 

x  -  decimal  number  of  empty  records  to  write 
(default:  1;  max:  262143) 


See  also:  WRITEF 

Examples:  WRITER, myf ile, 3. 


X  (IAF)  Execute  a  batch  command. 

Syntax:  X,ccc 

Parameters:  ccc  -  any  valid  batch  command  (up  to  80  chars) 

Examples:  X, BASIC  < —  compile  a  BASIC  program  without 

changing  to  the  BASIC  subsystem 


X, BASIC  Compile  a  BASIC  program  without  changing  to  the  BASIC 
subsystem. 

Syntax:  X, BASIC, I=lfn,B=lfn. 


Parameters : 


1  = 

omitted 


the  BASIC  source  program 
same  as  I=INPUT 


B=  -  the  output  object  module 

omitted  -  execute  without  creating  object  module 
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XEROX 


Similar  commands:  NOS/VE:  BASIC 

VMS:  RUN  (in  the  BASIC  subsystem) 


Examples:  X, BASIC , I=mybas . 

* —  compile  and  execute  (do  not 
create  an  object  module) 


X, BASIC, I=mybasi ,B=mybaso.  < —  compile 

mybaso.  < —  execute 


(DTRC,  Send  a  file  to  the  Xerox  8700. 


Syntax : 

Parameters : 


BEGIN , XEROX, ,lfn, copies, job, paper, duplex , forms , 
ascii, shift , ujn. 

lfn  -  the  local  file  to  be  sent 


Remarks : 


copies  -  number  of  copies 
(default:  1) 

job  -  Xerox  8700  job  name 
(default:  STDLND) 


paper  -  3~H0LE  or  PLAIN 
(default:  3-HOLE) 


duplex  -  YES  (2-sided)  or  NO  (1-sided) 
(default:  YES) 

forms  -  forms  overlay  name 

(default:  NONE) 

ascii  -  YES  (6/12-bit  display  code) 

NO  (6/6-bit  display  code) 

8  (8/12-bit  ASCII) 

(default:  NO) 


shift  “  0  ~  carriage  control  is  in  column  1 
1  -  single-spaced  listing 
(default:  0) 

ujn  -  change  the  "user  job  name"  field  on  the 
banner  page  (1-7  characters;  xxxxxxx) 
(default:  your  user  initials) 

While  each  output  has  a  unique  4-character  job 
sequence  number  in  the  banner,  the  UJN  parameter 
provides  you  with  another  way  to  identify  your 
output.  This  is  especially  useful  when  a  job  has 
multiple  outputs. 


Similar  commands:  NOS/VE:  XEROX  (DTRC) 

VMS:  XEROX,  XEROXD,  XEROXF,  XEROXFD 

(all  DTRC) 
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XMODEM 


Examples :  BEGIN, XEROX, ,mydata , J0B=ST4PRT, SHIFT=1 . 

A —  single-spaced  portrait  listing 
of  a  data  file 


BEGIN, XEROX, ,mydoc, ,DOCPRT. 

A —  print  a  document  having  carriage 
control  in  column  1  and  a  period 
(.)  in  column  76  of  top-of-page 
lines  which  are  to  be  forced 
onto  a  new  sheet 

BEGIN, XEROX, ,myout. 

A —  sent  an  output  file  to  be 
printed  landscape 


(IAF)  Transfer  a  file  between  NOS  and  a  PC  using  the 
Christensen  protocol. 

Syntax:  XMODEM, fn,td,ft,lf,sp,ec,fm,cf. 

XMODEM, FN=fn,TD=td,FT=ft,LF=lf,SP=sp,EC=ec, 
FM=fm,CF=cf . 

Parameters:  Required  ''if  omitted,  you  will  be  prompted  for 

them) : 

fn  -  file  to  be  transferred 

td  -  transfer  direction 

td  meaning 


s 

send 

from 

CYBER  to  micro 

R 

send 

from 

micro  to  CYBER 

ile 

type 

ft 

S/R 

meaning 

T 

S/R 

text 

6-bit  display  code 

A 

S/R 

text 

-  6/12-bit  display  code 

E 

S/R 

text 

-  8/12-bit  ASCII 

B 

S/R 

CYBER 

binary 

M 

S/R 

micro 

binary 

S 

R 

automatic  based  on  special 

characters  in  the  first  block 

Similar  commands:  NOS/VE:  XMODEM_RECEIVE;  XMODEM_SEND 

VMS:  use  KERMIT 


Examples : 


HELPME, XMODEM. 
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***  Interactive  Cray  Facility  Commands  *** 

The  Interactive  Cray  Facility  (ICF)  provides  the  CDC  NOS  user  with 
access  to  the  CRAY  X-MP. 

The  following  are  the  ICF  commands: 

/ABORT  Abort  an  interactive  Cray  job. 

Syntax:  /ABORT  (/AB) 

Remarks:  May  also  use  USER-BREAK-2  key. 

Similar  commands:  VMS  CRAY  context:  ABORT,  DROP,  KILL 

Examples:  /AB 

/ATTENTION  Send  an  attention  interrupt  to  the  interactive  Cray  job. 
Syntax:  /ATTENTION  (/AT) 

Remarks:  May  also  use  USER-BREAK-1  key. 

Similar  commands:  VMS  CRAY  context:  ATTENTION 
Examples:  /AT 

/BYE  Terminate  the  interactive  Cray  session. 

Syntax:  /BYE  HOLD  AP=NAM_application  (/B) 

/BYE  QUIT  AP=NAM_appl ication 

Parameters:  same  as  /LOGOFF 

Remarks:  Equivalent  to  LOGOFF. 

Similar  commands:  VMS  CRAY  context:  BYE,  QUIT 

Examples:  /BYE 

/CONNECT  Logically  connect  to  another  terminal  (such  as  a  plotter). 
Syntax:  /CONNECT  terminal_name  (/C) 

Parameters:  terminal_name 

See  also:  /ENDCONNECT,  /ICFSTATUS 


Similar  commands:  VMS  CRAY  context:  ATTACH 
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/DISCARD  Discard  all  output  sent  to  the  terminal. 

Syntax:  /DISCARD  (/D) 

Similar  commands:  VMS  CRAY  context:  DISCARD 
Examples:  /D 

/ENDCONNECT  Terminate  the  logical  connection  between  a  master  and 
slave  terminal. 

Syntax:  /ENDCONNECT  (/ENDC) 

See  also:  /CONNECT 

Examples:  /ENDC 

/ENDPLAY  Terminate  reading  from  a  PLAY  file. 

Syntax:  /ENDPLAY  (/ENDP) 

See  also:  /PLAY 

Examples:  /ENDP 

/EOF  Send  an  end-of-file  to  COS. 

Syntax:  /EOF  (/EO) 

Similar  commands:  VMS  CRAY  context:  EOF 
Examples:  /EOF 

/HELP  Display  a  brief  description  of  an  interactive  Cray  command. 

Syntax:  /HELP  command_name  (/H) 

Parameters:  command_name  “  command  for  which  help  is 

requested 

(default:  a  list  of  all  inter¬ 
active  commands  and 
their  parameters) 

Similar  commands:  VMS  CRAY  context:  HELP 


Examples : 


/H  EOF  or 
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/ICFSTATUS  Display  the  status  of  stations  and  terminals  connected  to 
ICF. 

Syntax:  /ICFSTATUS  (/I) 

Similar  commands:  VMS  CRAY  context:  ISTATUS 
Examples:  /I 


/LOGOFF  Terminate  an  interactive  Cray  session. 

Syntax:  /LOGOFF  HOLD  AP=NAM_application  (/LOGOF) 

/LOGOFF  QUIT  AP=NAM_appl i cat i on 


Parameters:  HOLD  -  suspend  the  interactive  session 

QUIT  -  quit  the  interactive  session 
(default:  QUIT) 

AP=  -  the  next  application 

Remarks:  same  as  /BYE 

See  also:  /LOGON 

Similar  commands:  VMS  CRAY  context:  BYE;  QUIT 

Examples:  /LOGOFF 

/LOGOFF  HOLD  AP=ICF 


/LOGON  Start  an  interactive  Cray  session  (or  reconnect  to  an  existing 
session) . 

Syntax:  /LOGON  MF=mf 

Parameters:  MF=  -  the  Cray  mainframe 

mf  meaning 

MCR  CRAY  X-MP  at  DTRC 


Remarks:  LOGON  is  not  allowed  if  you  are  already  logged 

on. 

At  the  exclamation  prompt  (!),  enter  an  ACCOUNT 
statement . 

See  also:  /LOGOFF 

Similar  commands:  VMS  CRAY  context:  INTERACTIVE 

VMS:  CINT;  CRAY  INTERACTIVE 


Examples : 


/LOGON 
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/PERIOD 


/PLAY 


/PREFIX 


Control  automatic  addition  of  a  period  terminator  to  Cray 
commands . 

Syntax:  /PERIOD  ON  (/PE) 

/PERIOD  OFF 

Parameters:  ON  -  ICF  supplies  the  terminating  period  on 

Cray  commands 

OFF  -  you  must  supply  the  terminating  period 
(default:  OFF) 

Examples:  /PE  ON 


Read  commands  and  data  from  a  NOS  file. 

Syntax:  /PLAY  filename  NOECHO  (/PL) 

Parameters:  filename  -  a  NOS  8/12-bit  ASCII  file 

NOECHO  -  N  -  do  not  echo  the  lines  as  they  are 
read 

(default:  echo  the  lines) 

Remarks:  /ENDPLAY 

Similar  commands:  VMS  CRAY  context:  PLAY 

Examples:  /PLAY  myascii 


Change  the  ICF  prefix  character. 

Syntax:  /PREFIX  pref ix_character  (/PR) 

Parameters:  pref ix_character  -  the  new  ICF  command  prefix 

character 

Remarks:  The  default  prefix  character  is  slash  (/) . 

To  restore  to  the  default,  use  "pPREFIX=/", 
where  "p"  is  the  current  prefix  character. 

Similar  commands:  VMS  CRAY  context:  none 

/PR=~  < —  change  to  tilde 

~ST  < —  display  status 

~PR=/  < —  restore  to  slash 

/ST  < —  display  status 


Examples : 
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/QUIT  Immediately  terminate  the  interactive  Cray  session. 

Syntax:  /QUIT  HOLD  AP=NAM_application  (/Q) 

/QUIT  QUIT  AP=NAM_appl icat ion 

Parameters:  same  as  /LOGOFF 

Remarks:  Can  also  use  LOGOFF  or  BYE. 

Similar  commands:  VMS  CRAY  context:  BYE;  QUIT 

Examples:  /QUIT 

/RESUME  Resume  a  suspended  interactive  Cray  session. 

Syntax:  /RESUME  (/R) 

See  also:  /SUSPEND 

Examples:  /R 

/STATUS  Display  Cray  job  status. 

Syntax:  /STATUS  (/ST) 

Similar  commands:  VMS  CRAY  context:  ISTATUS;  JSTAT;  STATUS 
Examples:  /ST 

/SUSPEND  Suspend  an  interactive  Cray  session. 

Syntax:  /SUSPEND  (/SU) 

See  also:  /RESUME 

Examples:  /SU 

/*  An  ICF  comment  line. 

Syntax:  /*  comment 

Parameters:  comment  -  optional  text 

Similar  commands:  VMS  CRAY  context:  COMMENT,  MESSAGE 
Examples:  /*  This  is  a  comment 
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*****  Glossary  ***** 

Alphabetic  (CDC  -  NOS) 

The  letters  A-Z. 

Alphabetic  (CDC  -  NOS/VE) 

The  letters  A-Z,  a~z. 

Alphabetic  (Cray  -  COS) 

$,  @,  and  the  letters  A-Z,  a~z. 

Alphabetic  (DEC) 

$,  _  (underscore),  and  the  letters  A~Z,  a~z  (upper  and 
lower  case  are  the  same) . 

Alphanumeric 

Alphabetic  and  the  digits  0~9. 

Dual-state 

The  state  in  which  two  operating  systems  operate 
simultaneously  in  the  same  mainframe.  At  DTRC,  the  CDC 
CYBER  860  operates  in  dual-state  with  NOS  and  NOS/VE. 

User  initials  (userid  or  username) 

The  4-character  ID  assigned  to  each  user  by  Code  3502. 
This  is  used  to  identify  jobs,  for  charge  authorization, 
to  identify  permanent  and  MSS  files,  magnetic  tapes,  etc. 
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*****  Index  ***** 


Note  -  NOS/BE  system  control  statements  are  flagged  with 
Intercom  commands  are  flagged  with 
UPDATE  directives  begin  with  *. 

Compiler  options  are  flagged  with  $. 

Primary  references  are  flagged  with  an  asterisk  after  the 
page  number,  for  example,  1-1*. 


*  (comment) 


9-2-2,  9-3-4*,  1-4*,  1-138* 


*/.A 

ABBREV 

Abbreviation 

Abort 

ABORT  (ICF) 

Absolute 

ACCEPT_LINE 

Access 

ACCESS 

Access  control  entry 

Access  control  list 

Access  mode 

ACCL 

Account  number 
Account  number,  default 

Accounting 

ADD 

ADDFILE 

ADD_LIBRARY 

ADD_MODULE 

Alphabetic 
Alphanumeric 
ANALYZE_OB JECT_LIBRARY 
ANAL YZE_PROGRAM_DYNAM ICS 
ANAOL 

ANAPD 

ANYM 

ANY_FAULT 
ANY  MAIL 


8- 2-5 

9- 4-3* 

H-l 

1-3,  1-17,  1-134 
1-134* 

9-5-1,  9-6-1 
H-l 08* 

8- 1-2,  9-1-2,  H-120,  H-124 

9- 2-4,  1-5*,  1-35,  1-129 
H-52,  H-54 

H-57,  H-59 
1-2* 

I!  iUo" 

8- 1-2,  1-19,  1-130 
1-19 

1-102 

9- 5-2* 

9-4-2* 

8-6-1 

8-5-2,  8-7-1* 

H-2,  Gl-1 
H-2,  1-119,  Gl-1 
8-2-11,  H-9* 

8-2-11,  H-10* 

H-9* 

H-10* 

H-10* 

H-3* 

8-2-11,  8-5-3,  H-10* 
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APPEND 

9-2-8,  1-6* 

Application 

1-15,  1-60,  1-75 

Application,  NAM 

1-6 

APPLLIB 

9-7-1 

APPSW 

9-2-5,  1-6* 

Arrow 

9-1-5 

ASCII 

9-2-4,  H-63,  1-7*,  1-98 

ASCII8 

1-29,  1-122 

Assign 

1-8 

ASSIGN 

9-2-6,  9-2-8,  9-2-9,  1-7* 

Asynchronous 

H-163,  H-165 

Attach 

H-ll 

ATTACH 

9-2-8,  9-7-1,  1-8*,  1-56 

ATTACH  FILE 

H-ll* 

ATTACH_JOB 

H-ll* 

ATTENTION  (ICF) 

1-134* 

ATTF 

H-ll* 

ATTJ 

H-ll* 

Attribute 

H-17,  H-18,  H-20,  H-22,  H~23, 

H-26,  H-28,  H-63,  H-66,  H~68, 

H-71,  H-75,  H-77,  H-78,  H-79, 

H-122,  H-147,  H-149,  1-103 

Attribute,  file 

H-122,  1-45 

Attribute,  function 

8-5-1 

Attribute,  procedure 

8-5-1,  H-135 

Attrubute 

H-64 

Audit 

H-59,  H-120,  1-16,  1-119 

Auto-drop 

1-103 

AUX 

9-2-6,  9-3-5,  1-8* 

Auxiliary  printer 

H-12,  1-8,  1-9 

AUXP 

H-12* 

AUXPRINT 

8-2-14,  8-5-3,  H-12* 

AUXPRNT 

9-2-6,  9-3-5,  1-9* 

Backspace 

1-12 

Backup 

H-12,  H-15,  H-57,  1-91 

BACKUP_PERMANENT_FILES 

8-2-8,  H-12* 

Backward 

H-153 

BACPF 

H-12* 

Banner  1-14 

BASIC  8-2-13,  9-2-4,  9-2-10,  H-12*, 

1-131 

8-1-5*,  9-1-7*,  H-3,  H-5,  H-7 
H-112,  H-116,  H-117,  H-162,  I 


H-25, 

H-69, 

H-80, 


I- 10*, 

,  H-45, 
-64, 


Batch 
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Bat-CAT 
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Batch 

1-131 

BATCH 

9-2-4,  I- 10* 

Batch  editor 

1-51,  1-123 

Batch  job  classes 

8-1-6*,  9-1-8* 

Batch  jobs,  killing 

8-1-6*,  9-1-8* 

BEFORE 

9-4-2*,  9-5-2* 

BEGIN 

9-2-1,  9-2-10, 

Beg inning- of- inf ormat ion 

1-97 

BELOAD 

1-11* 

BETONOS 

9-7-1 

Binary 

H-4,  H-33,  1-24 

Binary  mode 

1-127 

BINARY  OBJECT 

H-4* 

BKSP 

9-2-6,  1-12* 

BLANK 

9-2-9,  1-13* 

Blank  common 

9-6-4 

Block 

9-1-6*,  H-3,  H-. 

BLOCK 

8-2-1,  8-6-3,  9 

Block  data 

9-6-5 

Block  letters 

1-14 

BLOCKEND 

8-6-3,  H-13* 

BOI 

1-97 

Boolean 

H-2 

Break 

H-163 

BUILD 

9-5-2* 

BYE 

9-2-5,  1-15* 

BYE  (ICF) 

1-134* 

Cache  memory 

8-1-1,  9-1-1 

CALCFN 

9-7-2 

Cal  comp 

1-83 

CALC936 

9-7-2 

CALL 

9-4-2*,  9-4-5 

Call  by  name 

1-79 

Cancel 

1-4 

CANCEL 

8-2-1,  H-3,  H-L 

Capsule 

9-6-2 

Carderock 

1-122 

Case 

H-25 

Catalog 

8-8-1,  H-12,  H- 
H-57,  H-59,  H-8: 

CATALOG 

9-2-10,  1-15* 

Catalog,  working 

H-28,  H-82 

CATASTROPHIC 


H-4,  H-7 
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Category  Type 

1-2* 

CATLIST 

9-2-8, 

1-16* 

CAUSE 

8-2-1, 

H-14* 

Caution 

9-6-6 

CC  (Proc) 

9-3-1* 

CCL 

9-2-1 

CDC 

9-1-1* 

,  1-1, 

CDC  CYBER  180 

8-1-1* 

,  9-1- 

CDCnet 

9-1-1 

cdc860 

8-1-2, 

9-1-2 

CDEFINE 

1-17* 

CDROP 

1-17* 

Central  processing  unit 

8-1-1, 

9-1-1 

CHABLT 

H-15* 

CHACA 

H-17* 

CHACC 

H-15* 

CHACE 

H-16* 

CHACSM 

H-16* 

CHAFA 

H-17* 

CHAIA 

H-18* 

CHAIS 

H-19* 

CHAJA 

H-20* 

CHAJL 

H-21* 

CHALA 

H-22* 

CHALP 

H-22* 

CHAML 

H-23* 

change 

1-137 

Change 

1-18, 

1-31, 

CHANGE 

9-2-8, 

9-4-2 

CHANGE_BACKUP_LABEL_TYPE 

8-2-10 

,  H-15 

CHANGE  CATALOG  CONTENTS 

8-2-8, 

H-15* 

CHANGE  CATALOG  ENTRY 

8-2-8, 

H-16* 

CHANGE  COMMAND  DESCRIPTION 

8-7-2 

CHANGE  COMMAND  SEARCH  MODE 

8-2-2, 

8-8-2 

CHANGE_CONNECTION_ATTRIBUTES 

8-2-4, 

H-17* 

CHANGE_DECK 

8-6-1 

CHANGE  DECK  NAMES 

8-6-1 

CHANGE  DECK  REFERENCES 

8-6-1 

CHANGE  FILE  ATTRIBUTES 

8-2-8, 

H-17* 

CHANGE_FUNCT I ON_DESCR I P  T I ON 

8-7-2 

CHANGE  INPUT  ATTRIBUTE 

8-2-2, 

H-18* 

CHANGE  INTERACTION  STYLE 

8-2-4, 

H-19* 

CHANGE  JOB  ATTRIBUTE 

8-2-2, 

H-20* 

CHANGE  JOB  LIMIT 

8-2-2, 

H-21* 

CHANGE  LIBRARY 

8-6-1 

RevO 


1-86,  I- 


H-16* 


120 
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CHANGE  LINK  ATTRIBUTES 

8-2-4, 

H-22* 

CHANGE  LOGIN  PASSWORD 

8-2-2, 

H-22* 

CHANGE  MESSAGE  LEVEL 

8-2-2, 

H-23* 

CHANGE  MODIFICATION 

8-6-1 

CHANGE_MODULE_ATTRIBUTE 

8-7-2* 

CHANGE_OUTPUT  ATTRIBUTE 

8-2-2, 

H-23* 

CHANGE  PROGRAM  DESCRIPTION 

8-7-4* 

CHANGE  SCL  OPTION 

8-2-2, 

H-24* 

CHANGE  SCL  OPTIONS 

H-78 

CHANGE_TAPE_LABEL_ATTR IBUTES 

H-25* 

CHANGE  TERMINAL  ATTRIBUTES 

8-2-4, 

H-26* 

CHANGE  TERM_CONN  ATTRIBUTES 

H-17* 

CHANGE  TERM  CONN  DEFAULTS 

8-2-4, 

H-27 

CHANGE  UNSEEN  MAIL  ACTION 

H-27* 

CHANGE_UTILITY_ATTR IBUTES 

8-2-2, 

8-2-11 

CHANGE  WORKING  CATALOG 

8-2-7, 

H-28* 

CHANGE  170  REQUEST 

8-2-10 

,  H-14* 

CHAOA 

H-23* 

Character,  inhibit 

9-3-2 

Character,  master 

9-4-1 

Character,  prefix 

1-137 

Character  set 

1-31, 

1-42 

Characteristic 

1-18, 

1-120 

Charge 

8-1-4, 

9-1-6, 

CHARGE 

9-1-2, 

9-2-2, 

Charge  number 

9-1-2, 

1-17 

Charges 

H-139 

CHASCLO 

H-24* 

CHASO 

H-24*, 

H-78 

CHATA 

H-26* 

CHATCA 

H-17* 

CHAT LA 

H-25* 

CHAUA 

H-28* 

CHAUMA 

H-27* 

CHAWC 

H-28* 

CHAIR 

H-14* 

Checkpoint 

9-2-9, 

1-20, 

CHECK  FOR  MAIL 

8-2-11 

,  H-29* 

CHEFM 

H-29* 

Christensen  protocol 

1-133 

CHVAL.CN 

9-1-2, 

9-2-2, 

CJOB 

1-20* 

CKILL 

1-20* 

CKP 

9-2-9, 

1-20* 

CLEAR 

9-2-6, 

1-20* 

,  H-28* 


1-80 

I_19* 


1-94,  1-95 


1-19* 
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Clear  screen 

9-3-2 

Clock 

1-99 

CM 

1-2* 

Cobol 

9-6-8,  1-21 

COBOL 

8-2-13,  H-29* 

C0B0L5 

9-2-10,  1-21* 

Code,  condition 

8-4-4 

Code,  disposition 

1-17 

Code,  forms 

1-98 

Coded 

1-25,  1-100 

COLLECT  TEXT 

8-2-7,  8-5-1,  8-8-2,  H-32* 

COLT 

H-32* 

COM 

H-97 

Combine 

1-86 

COMBINE_LIBRARY 

8-6-1 

COMBINE  MODULE 

8-5-2,  8-7-5* 

COMDECK 

9-4-1*,  9-4-5 

COMF 

H-33* 

Command 

8-8-1,  H-l,  H-60,  H-88,  H-92,  I 
1-4,  1-40,  1-131,  1-134 

-1*, 

COMMAND 

8-2-^,  H-32* 

Command  environment 

H-l  05 

Command  file 

1-137 

Command  help 

8-4-1 

Command  list 

8-8-1,  8-8-2,  H-16,  H-41,  H-53, 

H-62,  H-l 38 

H-61, 

Command  list  entry 

8-8-1,  8-8-2 

Command  stream 

H-110,  H-l 11 

Command  table 

H-105,  H-163 

Command  table,  utility 

H-32 

Command  utility 

H-166 

COMMAND  FAULT 

H-3* 

COMMAND  LIST 

H-131,  H-137 

COMMD 

H-33* 

Comment 

9-3-4,  9-4-4,  1-4,  1-82,  1-138 

COMMENT 

9-2-2,  9-5-2*,  1-22* 

Common 

9-6-5 

Common,  blank 

9-6-4 

Common  block 

9-6-6 

COMOL 

H-33* 

Compare 

H-33,  H-105,  1-127 

COMPARE  FILE 

8-2-7,  H-33* 

COMPARE_OB JECT_LIBRARY 

8-2-12,  H-33* 

Compile 

H-12,  H-29,  H-100,  H-129,  1-21, 
1-52,  1-131 

1-48, 
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COMPILE 

9-4-2*.  9-4-6 

COMPRESS_MAIL_DAT ABASE 

8-2-11,  H-33* 

Computer  rates 

1-90 

Concatenate 

9-3-1 

Condition 

H-14,  H-168 

Condition  code 

8-4-4 

Condition,  damage 

H-15 

Condition  handler 

H-3 

Conditional 

9-3-2,  1-62 

Conditional  execution 

H-110,  H-169 

Conect 

H-43 

Connect 

H-54,  H-63,  H-65,  H-80 

CONNECT  (ICF) 

1-134* 

Connection,  interstate 

H-45,  H-55 

CONTENT 

9-3-5 

Continuation 

9-6-6 

CONTINUE 

8-2-1,  H-3*,  H-34* 

Control  Data  Corporation 

8-1-1,  9-1-1* 

Control  entry,  access 

H-52,  H-54 

Control  list,  access 

H-57,  H-59 

Control  sequence 

8-4-7 

Control  statement 

8-5-1,  8-8-2,  9-3-1 

Control,  transfer 

H-92 

CONUTS 

H-34* 

Convert 

H-34,  1-22,  1-42,  1-56,  1-89 

CONVERT  UPDATE  TO  SCU 

8-2-11,  8-2-12,  8-6-3,  H-34* 

COPF 

H-35* 

Copies 

1-98 

Copy 

H-32,  H-35,  H-106,  H-123,  H-140, 

1-22,  1-24,  1-25,  1-26,  1-28,  1-29, 

1-48,  1-100,  1-117 

COPY 

8-6-3,  9-2-6,  9-4-2*,  9-4-3*,  9-5-2* 
1-22* 

COPYBF 

9-2-6,  1-24* 

COPYBFR 

9-2-6,  9-3-5,  1-24* 

COPYBR 

9-2-6,  1-24* 

COPYC 

8-6-3 

COPYCF 

9-2-6,  1-25* 

COPYCR 

9-2-6,  1-25* 

COPYEI 

9-2-6,  1-26* 

COPYL 

9-2-10,  1-26* 

COPYLM 

9-2-10,  1-27* 

COPY SB F 

9-2-6,  1-28* 

COPYSF8 

9-2-6,  1-29* 

COPYX 

9-2-6,  1-29* 
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COPY_FILE 

’•CORE 

Core  image 
CORRECT  (Proc) 
COS 


Cray  station 
Create 

Create  a  file 

CREATE_BRIEF_HELP_MODULE 

CREATE_CATALOG 

CREATE_CATALOG_PERMIT 

CREATE_COKMAND_DESCRIPTION 

CREATE_COHMAND_LIST_ENTRY 

CREATE_DECK 

CREATE_DEFAULT_VARIABLE 

create_file 

CREATE_FILE_CONNECTION 

CREATE_FILE_PERMIT 

create_file_variable 

create_form_module 

create_full_help_message 
CREAT'  function_description 
C REA' E~INTERSTATE_CONNECTION 
CREATE_LIBRARY 
CREATE_L INKED_MODULE 

CREATE_MANUAL 

CREATE_MESSAGE_MODULE 

CREATE_MODIFICATION 

CREATE_MODULE 

CREATE  OBJECT  LIBRARY 


CREATE_PARAMETER_ASSIST_MESSAG 
CREATE  J3ARAM£TER_HELP_MESSAG£ 
CREATE_PARAMETER_PROMPT_MESSAG 
CREATE_PROGRAM_DESCR I PT ION 

CREATE_PROGRAM_PROFILE 
CREATE_STATUS_MESSAGE 
CREATE_TOPICS_FILE 
CREATE^VAX_REQUEST 
CREATE  170  REQUEST 


8- 

2-7, 

H-35* 

9- 

6-8* 

9- 

6-1 

9- 

3-1* 

G1 

-1 

H- 

139, 

1-65 

8- 

1-1, 

9-1-1 

H- 

160, 

H-161, 

I- 

32,  I 

-134, 

I- 

17 

9- 

3-1, 

9-4-5, 

I- 

121, 

1-123 

I- 

82 

8- 

4-2* 

8- 

2-8, 

H-39* 

8- 

2-8, 

H-39* 

8- 

-7-6 

8- 

2-2, 

8-8-2, 

8- 

6-1 

8- 

-2-13, 

H-42* 

8- 

-2-8, 

H-42* 

8- 

2-7, 

H-43* 

8- 

-2-8 

8- 

2-13, 

H-44* 

8- 

-7-6* 

8- 

-4-2* 

8- 

-7-7 

8- 

-2-4, 

H-45* 

8- 

-6-1 

8- 

-7-7* 

8- 

-2-11, 

H-46* 

8- 

-4-1* 

8- 

-6-1 

8- 

-7-7* 

8- 

-2-12, 

,  1 

l 

<r 

i 

00 

H- 

-46* 

8- 

-4-3* 

8- 

-4-3* 

8- 

-4-4* 

8- 

-7-8* 

8- 

-2-12 

H-47* 

8- 

-4-4* 

8- 

-2-11, 

H-48* 

8- 

-2-10, 

H-48* 

8- 

-2-10, 

H-36* 
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CREC 

H-39* 

CRECLE 

H-Al* 

CRECP 

H-39* 

CREDV 

H-A2* 

CREF 

H-A2* 

CREFC 

H-A3* 

CREFV 

H-AA* 

CREIC 

H-A5* 

CREM 

H-A6* 

CREMM 

8-A-l* 

CREOL 

8-5-2*.  8-7-1*,  H-25,  H-A6* 

CREPP 

H-A7* 

CRERUN 

1-30* 

CRETF 

H-A8* 

CREVR 

H-A8* 

CRE1R 

H-36* 

CSET 

9-2-A,  1-31* 

CSTATUS 

1-31* 

CSUBMIT 

9-2-2,  1-32* 

CT 

1-2* 

CTASK 

1-32* 

ctD 

1-5* 

ctE 

1-5* 

CTIME 

9-2-2,  1-33* 

ctS 

1-5* 

ctl 

I-A* 

ct2 

I-A* 

Cursor 

9-1-5 

CWEOF 

9 -A- 2* 

CYBER  control  language 

9-2-1 

CYBER  860 

9-1-1,  Gl-1 

Cycle 

H-15,  H-52,  H-53 ,  H-137 

CYCLE 

8-2-1,  H-A9* 

•/.D 

8-2-5,  9-2-A,  1-5* 

*DA 

9-6-8* 

Damage  condition 

H-15 

Data 

H- 166 

DATA  (Proc) 

9-3-1*,  9-3-2 

Date 

H-2,  1-33 

DATE 

9-2-12,  9-5-2*,  1-33* 

Dayf i le 

9-3-2,  1-22,  1-33,  1-36,  1-99,  I -  1 1 1 

DAYFILE 

9-2-2,  1-33* 

Debug 

H-A,  H-1A6,  H-1A7 
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Debug  library  list 

H-146 

1 

DEBUG  MODE 

H-4* 

DEC 

Gl-1 

DEC  VT-100 

9-1-3, 

9-3-2 

DECF 

H-50* 

Decimal 

H-2 

Deck 

9-4-1, 

H-84,  H-93,  H-96,  H-105 

DECK 

8-6-3, 

9-4-1*,  9-4-5 

Decrypt 

H-50 

DECRYPT_FILE 

8-2-11 

,  H-50* 

DEC  VT100  GOLD 

8-3-1 

Default 

H-15, 

H-42,  H-69,  H-147 

Default  account  number 

1-19 

DEFINE 

9-2-8, 

1-34*,  1-93 

DEFINE_PRIMARY_TASK 

8-2-2, 

H-51* 

DEFINE  TERMINAL 

8-2-4, 

H-51* 

Definition  file,  terminal 

H-51 

Definition,  panel 

1-87* 

Definition,  terminal 

1-118, 

1-120 

DEFT 

H-51* 

DELAC 

H-52* 

DELC 

H-52* 

DELCLE 

H-53* 

A 

DELCP 

H-52* 

w 

Delete 

H-52, 

H-125,  H-137 

DELETE 

9-4-2* 

,  9-4-6,  9-5-2* 

DELETE  ALL  CYCLES 

8-2-8, 

8-5-3,  H-52* 

DELETE  CATALOG 

8-2-8, 

H-52* 

DELETE  CATALOG  PERMIT 

8-2-9, 

H-52* 

DELETE_COMMAND_LIST_ENTRY 

8-2-2, 

8-8-2,  H-53* 

DELETE  DECK 

8-6-1 

DELETE  FEATURE 

8-6-1 

DELETE  FILE 

8-2-9, 

H-53* 

DELETE  FILE  CONNECTION 

8-2-7, 

H-54* 

DELETE_F I LE_PERMIT 

8-2-9, 

H-54* 

DELETE  GROUP 

8-6-1 

DELETE  INTERSTATE  CONNECTION 

8-2-4, 

H-55* 

DELETE  MODIFICATION 

8-6-1 

DELETE  MODULE 

8-5-2, 

8-7-9* 

DELETE_VARIABLE 

8-2-13 

,  8-5-1,  8-8-2,  H-55* 

DELF 

H-53* 

DELFC 

H-54* 

DELFP 

H-54* 

DELIC 

H-55* 

Delimit 

H-7 

• 
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DELV 

Density 

Descriptor,  value 
Design 

DESIGN_SCREEN 

DESS 

Destroy 

Detach 

DETACH_FILE 

DETACH_JOB 

DETF 

DETJ 

Diagram,  tree 
DIAL 

Differences 

Digit 

Direct  file 
Directive 

Directive,  LIBEDIT 
Directive,  reformatting 

Directive,  UPDATE 

DISAT 

DISBLT 

DISC 

DISCA 

DISCARD  (ICF) 

DISCE 

DISCI 

DISCL 

DISCLE 

DISCLO 

Disconnect 

DISCP 

DISF 

DISFA 

DISFC 

DISFI 

DISIA 

DISIS 

DISJA 

DISJAD 

DISJL 

DISJS 

DISL 

DISLA 


H-55* 

1-66 

H-2 

H-56 

8-2-4,  H-56* 

H-56* 

1-85 

H-56,  H-57,  1-5 
8-2-9,  H-56* 

8- 2-2,  H-57* 

H-56* 

H-57* 

9- 6-5* 

9-2-5,  1-35* 

1-128 

Gl-1 

9-1-6*,  1-8,  1-34,  1-57 

9-6-6 

9-5-1* 

9-1-7* 

9-4-1* 

H-57* 

H-57* 

H-57* 

H-63* 

1-135* 

H-59* 

H-60* 

H-61* 

H-62* 

H-78* 

H-54,  H-57 
H-60* 

H-63* 

H-64* 

H-65* 

H-66* 

H-66* 

H-70* 

H-68* 

H-69* 

H-70* 

H-70* 

H-72* 

H-71* 
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DISM 

H-73* 

DISOA 

H-75* 

DISOH 

H-76* 

DISOL 

H-73* 

DISOS 

H-77* 

DISOT 

H-74* 

DISPA 

H-77* 

Display 

8-1-3, 

9-1-3, 

H-152 

DISPLAY 

9-2-1, 

1-36* 

Display  code 

1-37 

DISPLAY  ACTIVE  TASKS 

8-2-5, 

H-57* 

DISPLAY  BACKUP  LABEL  TAPE 

8-2-10 

,  H-57* 

DISPLAY  CATALOG 

8-2-9, 

H-57* 

DISPLAY  CATALOG  ENTRY 

8-2-9, 

H-59* 

D I S P L A Y_COMMAND_ I NFORMAT I ON 

8-2-5, 

8-8-2, 

H-60* 

DISPLAY  COMMAND  LIST 

8-2-5, 

8-8-2, 

H-61* 

DISPLAY  COMMAND  LIST  ENTRY 

8-2-5, 

8-8-2, 

H-62* 

DISPLAY  COMMAND  PARAMETERS 

H-60* 

DISPLAY  CONNECTION  ATTRIBUTES 

8-2-4, 

H-63* 

DISPLAYDECK 

8-6-1 

DISPLAY  DECK  LIST 

8-6-1 

DISPLAY  DECK  REFERENCES 

8-6-2 

DISPLAY  FEATURES 

8-6-2 

DISPLAY  FEATURE  LIST 

8-6-2 

DISPLAY_FILE 

8-2-7, 

H-63* 

DISPLAY  FILE  ATTRIBUTES 

8-2-9, 

H-64* 

DISPLAY  FILE  CONNECTIONS 

8-2-7, 

H-65* 

DISPLAY  FUNCTION  INFORMATION 

8-2-11 

,  H-66* 

DISPLAY  GROUP 

8-6-2 

DISPLAY_GROUP_LIST 

8-6-2 

DISPLAY  INPUT  ATTRIBUTE 

8-2-7, 

H-66* 

DISPLAY  INPUT  STATUS 

H-70* 

DI SPLAY_ JOB_ATTR IBUTE 

8-2-2, 

H-68* 

DISPLAY_TOB_ATTRIBUTE  DEFAULT 

8-2-5 

DISPLAY_JOB_ATTRIBUTE_DEFAULTS 

H-69* 

DISPLAY  JOB  LIMIT 

8-2-5 

DISPLAY  JOB  LIMITS 

H-70* 

DISPLAY  JOB  STATUS 

8-1-6, 

8-2-5, 

H-70* 

DISPLAY  LIBRARY 

8-6-2 

DISPLAY_LINK_ATTRIBUTES 

8-2-4, 

H-  71* 

DISPLAY  LOG 

8-2-2, 

H-72* 

DISPLAY  MESSAGE 

8-2-2, 

H-73* 

DISPLAY  MODIFICATION 

8-6-2 

DISPLAY  MODIFICATION  LIST 

8-6-2 

DISPLAY  NEW  LIBRARY 

8-5-2, 

8-7-9* 

H-153 
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DISPLAY_OB JECT_LIBRARY 
DISPLAY_OB JECT_TEXT 
DI SPLAY_OUTPUT_ATTR I BUTE 
PI SPLAY_OUTPUT_HI STORY 
DI SP  LAY_OUTPUT_S TATUS 

DISPLAY_PRIN  T_S  TATUS 
DISPLAY_PROGRAM_ATTRIBUTES 
DISPLAY_SCL_OPTIONS 
DISPLAY_TAPE_LABEL_ATTRIBUTES 
D I  SP  LAY_T  ASKS  TATUS 

DISPLAY_TERMINAL_ATTRIBUTES 

DISPLAY_TERM_CONN_ATTRIBUTES 

DISPLAY_TERM_CONN_DEFAULTS 

DISPLAY_TOPICS_FILE 

DISPLAY_VALUE 

DISPLAY_VARIABLE_LIST 
D I S  P LA Y_WORK I NG_C ATALOG 
Dispose 

Disposition  code 
DISPS 

DISSO 

DISSPLA 

DISTA 

DISTCD 

DISTF 

DISTLA 

DISTS 

DISV 

DISVL 

DISWC 

DMB 

DMD 

DMP 

Dollar  sign 
DROP 

DTLIB 
DTNET 
DTRC 
DTI  00 

Dual-state 


8-2-12,  H-73* 

8-2-12,  H-74* 

8-2-2,  H-75* 

8-2-2,  H-76* 

8-2-3,  H-77* 

H-77* 

8-2-3,  H-77* 

8-2-3,  H-78* 

8-2-10,  H-78* 

8-2-3,  H-79* 

8-2-4,  H-79* 

H-63* 

8-2-4,  H-80* 

8-2-5,  H-80* 

8-2-14,  8-5-1,  8-8-2,  H-80* 

8-2-14,  8-5-1,  8-8-2,  H-81* 

8- 2-9,  H-82* 

1-98 

1-17 

H-77* 

H-78* 

9- 7-2 

H-63*,  H-79* 

H-80* 

H-80* 

H-78* 

H-79* 

H-80* 

H-81* 

H-82* 

9-2-8,  1-36* 

9-2-8,  1-37* 

9-2-8,  1-37* 

8- 5-1 

9- 1-8,  9-2-2,  1-37* 

8- 7-14*,  9-5-5,  9-7-1 

9- 1-9 

8- 5-3,  8-7-14,  9-3-5,  9-5-5,  H- 

9- 1-5,  1-101 

8- 1-1,  9-1-1,  H-22,  H-45,  Gl-1* 

9- 2-8,  H-63,  1-20,  1-36,  1-37, 
1-114,  1-119 

9-6-8 

1-11 

1-120 


Dump 

Dump,  Post  Mortem  (PMD) 

DUMPF 

Duplex 
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1-112, 
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Dynamic  load 


7.E 

Echo 

ECHO 

EDIC 

EDID 

EDIF 

EDIL 

Edit 

Editor  (batch) 

Editor  (FSE) 

EDIT_CATALOG 
EDIT_DECK 
EDIT_FILE 
EDITFILE  (editor) 

EDIT_LIBRARY 

ELSE 

ELSE  (Proc) 

ELSEIF 

EMA 

EMAIL 

Empty 

ENCF 

Encrypt 

ENCRYPT_FILE 

END 

ENDCONNECT  (ICF) 

ENDHELP  (Proc) 

ENDIF 

ENDIF  (Proc) 

ENDPLAY  (ICF) 

ENDTEXT 

ENDW 

End-of-f i le 
End~of- informat  ion 
End-of-record 

ENDJLIBRARY 

END_MESSAGE_MODULE 

ENQUIRE 

ENTER 

ENTER  (Proc) 

ENTER_F I LE_MANAGER 

ENTER  PROGRAMMING  ENVIRONMENT 


9-6-2 


9-2-4,  1-5* 

H-26 ,  1-120 

8- 2-5,  8-5-3,  H-82* 

H-83* 

H-84* 

H-84* 

H-84* 

H-83,  H-84,  H-105,  H-152 
1-51,  1-123 

9- 2-10,  1-51 

8-2-9,  H-83* 

8-2-12,  8-6-2,  H-84* 

8-2-11,  8-3-1*,  H-84* 

8-1-3 

H-84* 

8- 6-3,  9-2-1,  H-110*,  1-38*,  I~39 

9- 3-1*,  9-3-1 
8-6-3,  H-110* 

H-85* 

8-2-11,  H-85* 

1-131 

H-86* 

H-86 

8- 2-14,  H-86* 

9- 6-4 

1-135* 

9-3-1* 

9-2-1,  1-38,  1-39*,  1-105 
9-3-1,  9-3-1* 

1-135* 

9-4-3* 

9-2-1,  1-39* 

9-3-2,  1-135 
1-26,  1-105 
9-3-2 

8-6-2 

8- 4-6* 

9- 2-2,  1-39*,  1-69 
9-2-2,  1-40* 

9-3-2* 

8-2-7,  H-87* 

8-2-14,  H-87* 
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ENTFM 

H-87* 

^P  ENTPE 

H-87* 

Entry 

H-16,  H-41,  H-53,  H-62,  H-138 

Entry,  access  control 

H-52,  H-54 

Entry  point 

9-6-3,  1-41 

Environment 

H-42,  H-44,  H-131,  H-137 

Environment,  command 

H-105 

Environment,  file  migration 

H-128 

Environment,  programming 

H-87 

EOF 

1-86,  1-100,  1-105 

EOF  (ICF) 

1-135* 

EOF  (Proc) 

9-3-2* 

EOI 

1-26,  1-105 

EOR 

1-86,  1-100 

EOR  (Proc) 

9-3-2* 

EP 

1-120 

Erase 

1-85 

ERRMSG 

9-2-2,  1-41* 

Error 

H-3,  H-4,  H-7,  1-81 

ERROR 

H-4* 

Error  processing 

8-4-1 

ERROR  LEVEL 

H-4* 

Evaluate 

1-36 

Event 

H-168 

EVICT 

1-41* 

EX  (Proc) 

9-3-2* 

Exchange 

1-37 

Exchange  package 

1-36,  1-37 

EXCLUSIVE  (search) 

8-8-2 

EXEC 

H-88* 

Execute 

H-10,  H-88,  H-89,  1-37,  1-69, 
1-131 

1-91, 

EXECUTE 

9-2-4,  9-2-11,  9-6-3,  1-41* 

Execute-only 

9-7-1 

EXECUTE_COMMAND 

8-2-3,  8-8-1,  H-88* 

EXECUTE  INTERSTATE  COMMAND 

8-2-3,  H-88* 

EXECUTE  TASK 

8-2-13,  8-8-1,  H-89* 

Execution 

8-8-1*,  9-3-2 

Execution,  conditional 

H-110,  H-169 

Execution,  object  program 

9-6-8* 

Execution,  repetitive 

H-99,  H-117,  H-140,  H-169 

EXEIC 

H-88* 

EXET 

H-89* 

EXIT 

8-2-1,  9-2-1,  H-3*,  H-92*,  I- 

41* 

^P  EXP 

H-94* 
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EXPAND  (Proc) 

9-3-2* 

EXPAND  DECK 

8-6-2 

EXPAND  FILE 

8-6-2 

EXPAND  SOURCE_FILE 

8-2-12,  8-6-3,  H-93* 

EXPLAIN 

8-2-5,  9-2-5,  H-46,  H-94*.  1-42* 

EXPLAIN  MESSAGE 

8-2-5,  H-95* 

EXPM 

H-95* 

Expression 

H-80 

EXPSF 

H-93* 

External 

1-72 

Externals,  unsatisfied 

1-99 

Extract 

1-59 

EXTRACT  DECK 

8-6-2 

EXTRACT  MODIFICATION 

8-6-2 

EXTRACT_SOURCE_LIBRARY 

8-2-12,  8-6-3,  H-96* 

EXTSL 

H-96* 

FAMILY 

H-4* 

FATAL 

H-4,  H-7 

Fault,  any 

H-3 

Fault,  command 

H-3 

Fault,  limit 

H-3 

Fault,  program 

H-3 

FCOPY 

9-2-6,  1-42* 

Fetch 

H-123 

FETCH 

1-56 

Fiche 

1-83 

FICHE 

8-2-14,  8-5-3,  9-2-12,  9-3-5,  H-97*, 
1-44* 

Field  length 

1-79,  1-97,  1-103 

File 

9-2-6,  9-4-3,  H-2,  H-ll,  H-15,  H-17, 
H-35,  H-42,  H-43,  H-48,  H-52,  H-53, 

H-54,  H-56,  H-63,  H-64,  H-84,  H-105, 
H-106,  H-108,  H-lll,  H-122,  H-123, 
H-125,  H-131,  H-137,  H-138,  H-140, 
H-143,  H-144,  H-147,  1-7,  1-12,  1-15, 
1-22,  1-24,  1-25,  1-26,  1-28,  1-29, 

1-39,  1-41,  1-76,  1-85,  1-86,  1-97, 
1-105,  1-106,  1-111,  1-119,  1-122, 
1-127 

FILE 

9-2-6,  9-5-3*,  H-4*,  H-44,  1-45* 

File  attribute 

H-122,  1-45 

File,  command 

1-137 

File,  direct 

9-1-6*,  1-8,  1-34,  1-57 
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• 

File,  indirect 

9-1-6*,  1-6,  1-56,  1-57,  1-93,  1-98, 

1-100 

File,  local 

9-3-1,  1-69,  1-74,  1-93,  1-100, 

1-122 

File  management 

8-2-7 

File  Manager 

H-87 

File  mark 

1-131 

File  migration  environment 

H-128 

File  name,  local 

1-2* 

File,  object 

H-33,  H-74 

File,  permanent 

8- 1-1,  8-1-4*,  8-2-8,  9-1-1,  9-1-6*, 

9- 2-8,  H-12,  H-144,  1-3,  1-8,  1-16, 

1-18,  1-34,  1-56 

File,  procedure 

H-73 

File,  random 

1-24 

File,  terminal  definition 

H-51 

File  trandfer 

1-32 

File,  transfer 

9-1-9 

File  transfer 

H-116,  H-173,  H-175,  1-65,  1-133 

FILE_CGNNECTIONS 

H-131 ,  H-137 

FILE  MANAGEMENT  UTILITY 

8-2-7,  H-98* 

FILMU 

H-98* 

41 

Flag 

1-92,  1-101 

Flow  control 

8-2-1,  9-2-1 

FLR 

8-2-13,  9-2-11,  9-3-5,  1-48* 

FMU 

H-98* 

Fn  (Proc) 

9-3-2* 

Fold 

H-25 

FOR 

8-2-1,  H-99* 

FOR END 

H-99 

Form 

H-117 

FORM 

1-48* 

Format 

H-23 

Formatting,  screen 

1-87*,  1-105 

FORMAT_SCL_PROC 

H-99* 

FORMAT  SCL  PROCEDURE 

8-2-13,  8-5-1,  H-99* 

Forms  code 

1-98 

FORSCLP 

H-99* 

FORSP 

H-99* 

Fortran 

9-6-8,  1-52 

FORTRAN 

8-2-13,  9-2-4,  H-100*,  1-51* 

Forward 

H-153 

Front-end 

1-32 

• 

FSE 

FSE  (editor) 

9-1-5,  1-51* 

9-2-10 
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FTN 

FTN5 

FTP 

FTP  prolog  file 
FTPPRLG 

Ful 1-screen 
FUNCEND 
Function 
FUNCTION 

Function  attribute 

Function  keys 
Function  library 
Function  module 
Function  name 
Function  parameter 

Function  table 


GENCT 

GENERATE_COMMAND_TABLE 
GENERATE_LIBRARY 
GENERATE_SCU_EDI T _COMMANDS 
GENSEC 

GET 

GETASC 

GETATT 

GETF 

GETL 

GET_FILE 

GET_LINE 

Global 

GLOBAL 

GLOBAL  (search) 

GO 

GOODBYE 

GPSS 

GRIPE 

Group 

Group  identifier 
GTR 


H 

Handler,  condition 
Header,  procedure 
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8-6-3, 
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9-3-5, 

1-56* 

9-2-8, 
H-l 06* 
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1-57* 

8-2-7, 

H-106* 

8-2-14, 

8-5-1, 

8-8-2,  H-l 08* 

9-6-6, 

9-6-4 

8-8-2 

1-72 

9-2-2, 

1-57* 

9-2-5, 

9-7-1 

1-57* 

9-2-12, 
H-l  3 

9-3-5, 

1-58* 
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9-2-10, 

1-59* 
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HELLO 

9-2-5, 

1-60* 

Help 

9-3-1, 

9-3-2,  H-60,  H-94,  H-95,  1-42, 

1-61, 

1-62,  1-135 

HELP 

8-2-5 

7.HELP 

9-2-4 

HELP 

9-2-5, 

9-3-5,  H-46,  H-109*,  1-61* 

Help,  command 

8-4-1 

HELP  (ICF) 

1-135* 

Help  library 

8-4-1* 

HELP  (Proc) 

9-3-2* 

HELPBE 

9-2-5, 

1-62* 

HELPME 

9-2-5, 

1-62* 

Hexadecimal 

H-63 

History 

H-76 

Host 

1-74 

HOTSPOT 

9-7-1 

IAF 

9-1-1,  9-1-2 

IC  (Proc) 

9-3-2* 

ICF 

1-134* 

ICFSTATUS  (ICF) 

1-136* 

I  DENT 

9-4-2*,  9-4-6 

Identifier,  group 

9-5-1 

Identifier,  record 

9-5-1 

IF 

8-2-1,  8-6-3,  9-2-1, 
1-39,  1-62* 

H-110*,  1-38, 

IF  (Proc) 

9-3-1,  9-3-2* 

I  FEND 

8-6-3,  H-110* 

IGNORE 

9-5-3* 

IMSLM 

9-7-2 

IMSLSS 

9-7-2 

INCC 

H-110* 

INCF 

H— 111  * 

INCL 

H-lll* 

INCLUDE 

9-6-4,  1-123 

INCLUDE  COMMAND 

8-2-1,  8-5-1,  8-8-2, 

H-110* 

INCLUDE_FILE 

8-1-5,  8-2-1,  8-5-1, 

8-8-2,  H-lll* 

INCLUDE_LINE 

8-2-1,  8-5-1,  8-8-2, 

H-lll* 

Indirect  file 

9-1-6*,  1-6,  1-56,  I- 
1-100 

-57,  1-93,  1-98 

INFORMATIONAL 

H-4,  H-7 

Inhibit  character 

9-3-2 

INIT 

INITIALIZE  TERMINAL 


H-112* 

8-2-4,  H-112* 
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Input 

9-3-4,  H-18,  H-66,  I 

INPUT 

H-5* 

Input  queue 

1-111 

Insert 

H-110,  H— 111 

INSERT 

9-4-2*,  9-4-6,  9-5-: 

Instruction  stack 

8-1-1,  9-1-1 

Interaction  style 

8-3-1 

Interaction  stype 

H-19 

INTERACT I 0N_STYLE 

H-131,  H-137 

Interactive 

8-2-4,  9-2-4,  H-3,  I 

H-161,  1-101,  1-138 

interactive  Cray  Facility 

1-134* 

Interactive  Facility 

8-1-1*,  9-1-1 

Interactive  procedure 

1-10 

Interactive  status 

8-2-5 

Interpreter 

H-24 

Interrupt 

H-163,  1-4,  1-134 

INTERRUPT 

H-3* 

Interstate 

H-88 

Interstate  connection 

H-45,  H-55 

ITEMIZE 

9-2-10,  1-63* 

Iterate 

H-49 

I/O 

8-1-1 

7.J 

8-2-5 

JCL 

1-1 

j  ob 

9-2-2 

Job 

H-3,  H-7,  H-ll,  H-li 
H-42,  H-51,  H-56,  H 

H-70,  H-72,  H-76,  H 
H-145,  H-160,  H-161 
1-20,  1-32,  1-39,  I 
1-103 

JOB 

8-1-5,  8-2-3,  8-8-2 

Job,  batch 

8-1-5*,  9-1-7* 

Job  classes,  batch 

8-1-6*,  9-1-8* 

Job  control 

8-2-1,  9-2-2 

Job  control  language 

8-2-1,  9-2-1,  1-1 

Job  control  statement 

8-5-1,  9-3-1 

Job  flow 

8-8-2 

Job  library  list 

H-77 

Job  name 

H-5,  H-7,  1-3 

Job  order  number 

8-1-2,  9-1-2,  H- 147 

Job  processing 

8-2-5,  9-2-5 
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Job  Sequence  Name 

1-2 

Job  sequence  number 

1-129 

Job  step 

1-104 

J0BC0ST 

9-2-2,  9-3-5,  1-65* 

JOBEND 

8-8-2 

Jobs,  killing  batch 

9-1-8* 

JOB  NAME 

H-5*,  H-7* 

JSN 

1-2* 

KFRMIT 

8-2-5, 

H-116*,  1-65 

Keypad 

8-1-3, 

9-1-5 

Key.,,  function 

8-1-3, 

9-1-3,  9-3-2 

Keys,  terminal 

8-1-3, 

9-1-3 

Keyword 

H-2 

Keyword  parameter 

1-1* 

Killing  batch  jobs 

8-1-6* 

,  9-1-8* 

Label 

9-3-1,  H-15,  H-25,  H-57,  H-78, 
1-38,  1-39,  1-74 

LABEL 

9-2-9,  1-65* 

Language 

8-2-13,  9-2-10 

LDSET 

9-2-11,  9-6-3,  9-6-4,  1-68* 

LENGTH 

9-2-2,  1-69* 

Length,  line 

H-27 

Length,  page 

H-27 

Letter 

Gl-1 

LFN 

1-2* 

LGO 

9-2-11,  9-6-3,  1-69* 

LIBEDIT 

9-2-10,  9-5-1*,  1-70* 

LIBEDIT  directive 

9-5-1* 

LIBGEN 

9-2-10,  9-5-1,  9-5-3*,  1-71* 

LIBLOAD 

9-2-11,  9-6-3,  1-72* 

Library 

9-2-10,  1-48,  1-59,  1-68,  1-70, 
1-128 

LIBRARY 

9-2-10,  9-2-11,  9-6-3,  9-7-1,  I 

Library,  function 

8-5-2,  8-5-3 

Library,  help 

8-4-1* 

Library  list,  debug 

H-146 

Library  list,  job 

H-77 

Library  maintenance 

8-2-12 

Library,  message 

8-4-1* 

Library,  object 

8-7-1*,  8-7-14*.  8-8-1,  9-5-1*, 

1-13, 


1-72, 

-72* 


H-9, 


H-33,  H-46,  H-73,  H-74 
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Library,  procedure 

8-5-2*,  8-5-3,  9-3-5 

Library,  program 

8-7-14,  9-4-1,  1-123 

Library,  source 

8-6-1,  H-34,  H-96,  H-159 

Library,  subprogram 

8-7-14 

Library,  user 

1-71,  1-121 

Limi  t 

H-21,  H-70 

LIMIT 

9-4-4* 

Limit,  output  line 

9-6-8,  1-54 

Limit,  print 

1-54 

Limit,  SRU 

1-102,  1-104 

Limit,  time 

1-104 

LIMITS 

9-2-2,  1-73* 

LIMIT_FAULT 

H-3* 

Line 

8-3-1,  H— 111 

LINE 

9-2-4,  1-73* 

Line  length 

H-27 

Line  limit,  ou'put 

9-6-8,  1-54 

Line  mode 

H-19 

Link 

H-22,  H-71 

LINPACK 

9-7-2 

List 

H-2\  1-15,  1-16 

LIST 

9-2-5,  9-4-3*.  9-5-3*,  H-5*,  1-74* 

List,  access  control 

H-57,  H-59 

List,  command 

H-41,  H-53,  H-61,  H-62,  H-138 

List,  debug  library 

H-146 

List,  job  library 

H-77 

List  of  users 

1-130 

LISTLB 

9-2-9,  1-74* 

L1STLID 

9-2-2,  1-74* 

Load 

9-5-1,  1-11,  1-68,  1-69,  1-72,  1-77, 

1-79,  1-81,  1-107 

LOAD 

9-2-11,  9-6-1,  9-6-3,  9-6-4,  1-75* 

Load  map 

9-6-6,  1-41,  1-68,  1-77,  1-81 

Load  module 

8-7-1,  H-10 

l.oader 

8-2-13,  9-2-11,  9-6-1*,  H-9,  1-92 

Load/dump  memory 

8-2-10 

Local  file 

9-3-1,  1-69,  1-74,  1-93,  1-100. 

1-122 

Local  file  name 

1-2* 

LOCALE I LE_NAME 

H-5* 

LOCK 

9-2-6,  1-75*,  1-122 

Log 

H-72,  H-73,  H-76,  1-33 

Log  i  n 

H-147,  1-19,  1-60 

LOGIN 

8-2-6,  8-8-2,  9-2-5,  H-116*,  1-75* 

LOGINPR 

1-126* 
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LOGOFF  (ICF) 

1-136* 

LOGON  (ICF) 

1-136* 

LOGOUT 

8-2-6,  8-8-2,  9-2-5,  H-117*,  1-76* 

Loop 

1-39,  1-129 

LOOP 

8-2-1,  H-117* 

LOOPEND 

H-117* 

Lower  case 

9-1-9 

L072 

9-2-6,  1-76* 

Mail 

H-10,  H-27,  H-29,  H~33,  H~85 

MANAGE  FORM 

8-2-12,  H-117* 

MANAGE  JOB 

8-2-6,  H-118* 

MANAGE  OUTPUT 

8-2-6,  H-118* 

MANF 

H-117* 

MANJ 

H-118* 

MANO 

H-118* 

Manual,  on-line 

8-9-1*,  H-46,  H-48,  H~80,  H-94, 
H-109,  1-42 

Manual,  topics 

H-48 

MAP 

9-2-11,  9-6-1,  9-6-3,  1-77* 

Map,  load 

5-6-6,  1-41,  1-68,  1-77,  1-81 

Mark,  substitution 

H-7 

Mass  Storage  System 

8-1-1,  8-2-9,  9-1-1,  H-120,  H-122, 
H-123,  H-124,  H-125 

Master 

1-134,  1-135 

Master  character 

9-4-1 

ME  APE 

H-118* 

Measure 

H-10 

Measurement,  program 

H-118 

MEASURE_PROGRAM_EXECUTION 

8-2-12,  H-118* 

Medium-speed 

8-1-1,  9-1-1 

Memory 

8-1-1,  9-1-1,  1-2,  1-37 

Memory  image 

9-6-1 

Menu 

9-3-2,  H-145 

MENU 

H-145* 

MERGE 

8-2-7,  H-119*,  1-78* 

Message 

9-3-2,  H-4,  H-23,  H-73,  H-95,  H-145, 
1-35,  1-41 

Message  library 

8-4-1* 

Message  module 

8-4-1,  8-5-2 

Message,  status 

8-4-1,  8-4-8 

Message  text 

8-4-7* 

MESSAGE  LEVEL 

H-131,  H- 138 

MFL 

9-2-2,  1-79* 
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Microcomputer 

1-65 

Microfiche 

H-97, 

1-44*, 

1-83 

Migration  environment,  file 

H- 128 

Mode 

1-7 

MODE 

1-79* 

Mode,  line 

H-19 

Mode,  screen 

H-19 

Mode,  search 

8-8-2, 

H-16 

Modify 

9-4-2 

MODIFY 

1-79* 

Module,  function 

8-5-2 

Module,  load 

8-7-1, 

H-10 

Module,  message 

8-4-1, 

8-5-2 

Module,  object 

9-5-1, 

9-6-1, 

1-26, 

Module,  procedure 

8-5-2 

Module,  text 

9-4-1 

Mount 

1-65 

MOVE 

9-4-2* 

MSACCES 

8-2-9, 

8-5-3, 

H-120* 

MSAUDIT 

8-2-9, 

8-5-3, 

9-3-5, 

MSCATLIST 

8-2-9, 

8-5-3, 

H-122* 

MSCHANG 

8-2-9, 

8-5-3, 

H-122* 

MSFETCH 

8-2-9, 

8-5-3, 

H-123* 

MSFILES 

8-2-9 

*MSGS 

9-6-8* 

MSPASSW 

8-2-9, 

8-5-3, 

H-124* 

MSPURGE 

8-2-10 

,  8-5-3 

,  H-125 

MSS 

H-120, 

H-122, 

H-123, 

MSSTORE 

8-2-10 

,  8-5-3 

,  H-125 

Multi-file 

1-44, 

1-67,  I 

-74 

1-27,  1-75 


H-120* 


Vc 

H-124,  H-125 

it 


NA 

NAM  application 

name 

Name 

Name,  function 
Name,  job 

Name,  job  sequence 
Name,  local  file 
Name,  procedure 
NATURAL  LANGUAGE 


1-3* 

1-6 

8- 2-13,  9-2-1,  9-2-11 

9- 3-3,  H-2 
8-5-1 

H-5,  H-7 
1-2 
1-2* 

8-5-1,  H-135 
H-131,  H-138 


9-6-3, 


1-79* 


Network 

NEW 

New  routines 


9-1-9*,  1-74 
9-5-3* 

1-80 
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NEWCHRG 

9-2-2,  9-3-5,  1-80* 

NEWR 

H-127* 

NEWRTNS 

9-2-12,  9-3-5,  1-80* 

News 

H-127,  H-128,  H-139,  1-80,  1-84, 

1-90 

NEWS 

8-2-14,  8-5-3,  9-2-12,  9-3-5,  H-128*, 

1-80* 

NEW  ROUTINES 

8-2-14,  8-5-3,  H-127* 

NOABBREV 

9-4-3* 

NOCLR  (Proc) 

9-3-2* 

NOEXIT 

9-2-1,  1-81*,  1-84 

NOGO 

9-2-11,  9-6-3,  1-81* 

NOINS 

9-5-3* 

NOLIST 

9-4-4* 

NOREP 

9-5-3* 

NORERUN 

9-2-2,  1-81* 

NOREW 

9-5-4* 

NORMAL 

9-2-4,  1-82* 

NOS 

8-1-1,  9-1-1,  H-14,  H-22,  H-36,  H-45, 

H-71,  H-88,  H-106,  H-120,  H-122, 

H-123,  H-124,  fl-125,  H-140,  H-143, 

1-1,  Gl-1 

NOS/BE 

1-11,  1-62 

NOS/VE 

8-1-1*,  Gl-1 

NOTE 

9-2-2,  1-22,  1-82* 

• 

NOTE  (Proc) 

9-3-2* 

NSYS 

8-10-1*,  9-5-5,  9-7-2 

NULL 

9-2-4 

$NULL 

H-4,  H-5,  H-30,  H-101,  H-102,  H-129, 

H-131,  H-150,  H-174,  H-176 

NULL 

1-83* 

Number,  job  order 

H- 147 ,  H-171 

Number,  project 

H-147 

OASYS 

9-1-9 

Object 

H-131,  H-137 

Object  file 

H-33,  H-74 

Object  library 

8-7-1*,  8-7-14*,  8-8-1,  9-5-1*,  H-9, 

H-33,  H-46,  H-73,  H-74 

Object  module 

9-5-1,  9-6-1,  1-26,  1-27,  1-75 

Object  program  execution 

9-6-8* 

Object  record 

H-74 

Octal 

H-2,  1-2,  1-37,  1-119 

PP  OFFSW 

9-2-2,  1-83* 
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Off-line  request 

1-83* 

OFLREQ 

9-2-12,  9-3-5, 

1-83* 

OLD 

9-5-4* 

OLDN 

H-128* 

OLDNEWS 

9-2-12,  9-3-5, 

1-84* 

OLD_NEWS 

8-2-14,  8-5-3, 

H-128* 

Omit 

9-3-1 

ONEX IT 

9-2-1,  1-84* 

ONSW 

9-2-2,  1-84* 

On-line 

1-61,  1-62 

On-line  manual 

8-9-1*,  H-46, 
H-109,  1-42 

H-48,  H-80,  H-94, 

*OP 

9-6-8* 

OPEFMA 

H-128* 

OPEN_FILE_MIGRATION_AID 

8-2-7,  H-128* 

Operating  system 

8-1-1,  9-1-1 

Operator 

H-145 

Option 

H-24,  H-78 

OUT 

9-2-6,  1-85* 

Output 

H-5*,  H-23,  H- 

75,  H-76,  H-77,  H 

H-145,  H-165, 

1-20,  1-135 

OUTPUT 

H-5* 

Output  line  limit 

9-6-8,  1-54 

Overlay 

9-6-2 

Overwrite 

1-85 

OVWRITE 

9-2-6,  1-85* 

PACK 

9-2-6,  1-86* 

Page  length 

H-27 

PAGE  (Proc) 

9-3-2* 

Page  width 

H-27 

Panel 

1-105 

Panel  definition 

1-87* 

Parameter 

9-3-3,  9-3-4,  H-4,  H-9,  H-60,  I 
1-2,  1-10 

Parameter,  function 

8-5-1 

Parameter,  keyword 

1-1* 

Parameter,  positional 

1-1* 

Parameter,  procedure 

8-5-1,  H-135 

Parameter  Substitution 

8-4-7 

Parity 

H-27 

PASCAL 

8-2-13,  H- 129* 

PASSWOR 

Password 


9-2-3,  1-86* 

8-1-2,  9-1-2,  H-5* ,  H-22,  H-124,  1-3, 
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• 

Password 

1-17,  1-86,  1-127 

PASSWORD 

H-5* 

pathname 

8-2-13 

Pattern 

H-25 

Pause 

H-163,  1-57,  1-86 

PAUSE 

9-2-3,  H-3*,  1-86* 

PC 

1-65 

PCA 

H-118 

PDU 

1-87* 

PERIOD  (ICF) 

1-137* 

Peripheral  processor 

8-1-1,  9-1-1 

Permanent  file 

8- 1-1,  8-1-4*,  8-2-8,  9-1-1,  9-1-6*, 

9- 2-8,  H-12,  H-144,  1-3,  1-8,  1-16, 

1-18,  1-34,  1-56 

Permission 

8-2-8,  8-2-9,  9-1-9,  9-1-10,  9-2-8, 

H-39,  H-52,  H-54,  1-2*,  1-88 

PERMIT 

9-2-8,  1-88* 

PERT78 

9-7-1 

PFN 

1-3* 

PL 

9-4-1*,  9-4-5 

*PL 

9-6-8* 

PL  (program  library) 

1-123 

• 

PLAY 

1-135  1 

PLAY  (ICF) 

1-137* 

Plural 

H-l 

PMD 

9-6-8 

POP 

8-2-14,  H-131* 

Pop  up 

H-152,  H-153 

Pos i t ion 

H-144,  H-153,  1-97,  1-105,  1-106 

Positional  parameter 

1-1* 

Post  Mortem  Dump  (PMD) 

9-6-8 

PP 

8-1-1,  9-1-1 

Prefix  character 

1-137 

PREFIX  (ICF) 

1-137* 

Preset 

1-68,  1-103 

PRIF 

H-131* 

Print 

H-12,  H-131,  H-165,  H-171,  1-28, 

1-29,  1-122 

Print  limit 

1-54 

Printer 

9-1-1 

Printer,  auxiliary 

H-12,  1-8,  1-9 

PRINT  FILE 

8-2-7,  H-131* 

Priority  (batch) 

1-64 

• 

Priority  (batch  job) 

8-1-6,  9-1-8 

Private 

1-88 
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PROC  (Proc) 

9-3-3* 

Procedure 

8- 2-11,  8-5-1*,  8-8-1,  9-2- 

9- 3-1*,  9-3-1,  9-3-5,  H-99, 
1-10,  1-41,  1-73,  1-96 

PROCEDURE 

8-2-11,  8-5-1,  H-135* 

Procedure  attribute 

8-5-1,  H-135 

Procedure  file 

H-73 
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H-165* 

TERF 
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